TextStream Object

One key function of FileSystemObject Component is the manipulation of text file of the file system. TextStream Object facilitates sequential access to text file.

TextStream.Write

TextStream.Write method is the method to write the specified string to the opened TextStream file  corresponding to the instance of specified TextStream object.

Syntax:

TextStreamName.Write(string)

 Or in VBScript. Imply

TextStreamName.Write(string)

 Or in JScript. Imply

 TextStreamName.Write(string)

Parameters:

TextStreamName

The parameter "TextStreamName" is used to specify the name of the instance of the TextStream Object related to.

string

The parameter "string" is used to specify the character string to be written to the text stream file of the instance of the specified TextStream Object.

Remarks:

TextStreamName refers to a TextStream Object.

When the instance of the TextStream object of the specified file is opened for reading only, no text can be written to the file.

The specified string is just written to the file with no intervening spaces or characters between each string by the Write method. However, the WriteLine method write a newline character or a string that ends with a newline character.

Examples:

• Example of using the Write method to write a string to the opened TextStream object.

  ASP VBScript command:

  <script runat="server" language="VBScript">
  Dim fso, textobjectname
  const ForReading=1, ForWriting=2, FileCreate=True
  Set fso = CreateObject("Scripting.FileSystemObject")
  Set textobjectname = fso.OpenTextFile("d:\temp1\test.txt", ForWriting,FileCreate)
  textobjectname.Write("Hel")
  textobjectname.Write("lo")
  textobjectname.Close
  Set textobjectname = fso.OpenTextFile("d:\temp1\test.txt", ForReading)
  Response.Write textobjectname.Read(3)  & "<br /> "
  Response.Write textobjectname.AtEndOfLine & "<br /> "
  Response.Write textobjectname.AtEndOfStream & "<br /> "
  Response.Write textobjectname.Read(2)  & "<br /> "
  Response.Write textobjectname.AtEndOfLine & "<br /> "
  Response.Write textobjectname.AtEndOfStream & "<br /> "
  textobjectname.Close
  </script>

  HTML web page ouput:

  Hel
  False
  Falsee
  lo
  True
  Truee

• Example of using the Write method to write a string to the opened TextStream object.

  ASP JScript command:

  <script runat="server" language="JScript">
  var fso, textobjectname;
  var ForReading=1, ForWriting=2, FileCreate=true;
  fso = new ActiveXObject("Scripting.FileSystemObject");
  textobjectname = fso.OpenTextFile("d:\\temp1\\test.txt", ForWriting,FileCreate) ;
  textobjectname.Write("Hel") ;
  textobjectname.Write("lo") ;
  textobjectname.Close();
  textobjectname = fso.OpenTextFile("d:\\temp1\\test.txt", ForReading) ;
  Response.Write (textobjectname.Read(3) + "<br /> ");
  Response.Write (textobjectname.AtEndOfLine + "<br /> ");
  Response.Write (textobjectname.AtEndOfStream + "<br /> ");
  Response.Write (textobjectname.Read(2) + "<br /> ");
  Response.Write (textobjectname.AtEndOfLine + "<br /> ");
  Response.Write (textobjectname.AtEndOfStream + "<br /> ");
  textobjectname.Close();
  </script>

  HTML web page ouput:

  Hel
  false
  false
  lo
  true
  false

TextStream.WriteBlankLines

TextStream.WriteBlankLines method is the method to write a specified number of newline characters to the opened TextStream file  corresponding to the instance of specified TextStream object.

Syntax:

TextStreamName.WriteBlankLines(lines)

 Or in VBScript. Imply

TextStreamName.WriteBlankLines(lines)

 Or in JScript. Imply

 TextStreamName.WriteBlankLines(lines)

Parameters:

TextStreamName

The parameter "TextStreamName" is used to specify the name of the instance of the TextStream Object related to.

lines

The parameter "lines" is used to specify the number of newline characters  to be written to the text stream file of the instance of the specified TextStream Object.

Remarks:

TextStreamName refers to a TextStream Object.

Examples:

• Example of using the WriteBlankLines method to write a string to the opened TextStream object.

  ASP VBScript command:

  <script runat="server" language="VBScript">
  Dim fso, textobjectname
  const ForReading=1, ForWriting=2, FileCreate=True
  Set fso = CreateObject("Scripting.FileSystemObject")
  Set textobjectname = fso.OpenTextFile("d:\temp1\test.txt", ForWriting,FileCreate)
  textobjectname.Write("Hel")
   textobjectname.WriteBlankLines(1)
  textobjectname.Write("lo")
  textobjectname.Close
  Set textobjectname = fso.OpenTextFile("d:\temp1\test.txt", ForReading)
  Response.Write textobjectname.Readline  & "<br /> "
  textobjectname.Close
  </script>

  HTML web page ouput:

  Hel

• Example of using the Write method to write a string to the opened TextStream object.

  ASP JScript command:

  <script runat="server" language="JScript">
  var fso, textobjectname;
  var ForReading=1, ForWriting=2, FileCreate=true;
  fso = new ActiveXObject("Scripting.FileSystemObject");
  textobjectname = fso.OpenTextFile("d:\\temp1\\test.txt", ForWriting,FileCreate) ;
  textobjectname.Write("Hel") ;
  textobjectname.WriteBlankLines(1) ;
  textobjectname.Write("lo") ;
  textobjectname.Close();
  textobjectname = fso.OpenTextFile("d:\\temp1\\test.txt", ForReading) ;
  Response.Write (textobjectname.Readline() + "<br /> ");
  textobjectname.Close();
  </script>

  HTML web page ouput:

  Hel

TextStream.WriteLine

TextStream.WriteLine method is the method to write the specified string together with a newline character to the opened TextStream file  corresponding to the instance of specified TextStream object.

Syntax:

TextStreamName.Write([string])

 Or in VBScript. Imply

TextStreamName.Write([string])

 Or in JScript. Imply

 TextStreamName.Write([string])

Parameters:

TextStreamName

The parameter "TextStreamName" is used to specify the name of the instance of the TextStream Object related to.

string

The optional parameter "string" is used to specify the character string is ato be written to the text stream file of the instance of the specified TextStream Object. A newline character is added automatically. If the optional parameter "string" is omitted, only the newline character is written to the file.

Remarks:

TextStreamName refers to a TextStream Object.

Examples:

• Example of using the WriteLine method to write a string to the opened TextStream object.

  ASP VBScript command:

  <script runat="server" language="VBScript">
  Dim fso, textobjectname
  const ForReading=1, ForWriting=2, FileCreate=True
  Set fso = CreateObject("Scripting.FileSystemObject")
  Set textobjectname = fso.OpenTextFile("d:\temp1\test.txt", ForWriting,FileCreate)
  textobjectname.WriteLine("Hel")
  textobjectname.WriteLine("lo")
  textobjectname.Close
  Set textobjectname = fso.OpenTextFile("d:\temp1\test.txt", ForReading)
  Response.Write textobjectname.ReadLine()  & "<br /> "
  Response.Write textobjectname.ReadLine()  & "<br /> "
  textobjectname.Close
  </script>

  HTML web page ouput:

  Hel
  lo

• Example of using the WriteLine method to write a string to the opened TextStream object.

  ASP JScript command:

  <script runat="server" language="JScript">
  var fso, textobjectname;
  var ForReading=1, ForWriting=2, FileCreate=true;
  fso = new ActiveXObject("Scripting.FileSystemObject");
  textobjectname = fso.OpenTextFile("d:\\temp1\\test.txt", ForWriting,FileCreate) ;
  textobjectname.WriteLine("Hel") ;
  textobjectname.WriteLine("lo") ;
  textobjectname.Close();
  textobjectname = fso.OpenTextFile("d:\\temp1\\test.txt", ForReading) ;
  Response.Write (textobjectname.Readline() + "<br /> ");
  Response.Write (textobjectname.Readline() + "<br /> ");
  textobjectname.Close();e.Close();
  </script>

  HTML web page ouput:

  Hel
  false
  false
  lo
  true
  false