ASP TextStream Object

---

The TextStream object is used to access the
contents of a text file.

---

Examples

Read
textfile

This example demonstrates how to use the OpenTextFile method of the
FileSystemObject to create a TextStream Object. The ReadAll method of the
TextStream Object reads from the opened text file.  

Read
only a part of  a textfile

This example demonstrates how to only read a part of a TextStream file.

Read
one line of a textfile

This example demonstrates how to read one line from a TextStream file.

Read
all lines from a textfile

This example demonstrates how to read all the lines from a TextStream file.

Skip
a part of a textfile

This example demonstrates how to skip a specified number of characters when
reading the TextStream file.

Skip
a line of a textfile

This example demonstrates how to skip a line when reading the TextStream file.

Return
line-number

This example demonstrates how to return the current line number in a TextStream
file.

Get
column number

This example demonstrates how to get the column number of the current character
in a file.

---

The TextStream Object

The TextStream object is used to access the contents of text
files.

The following code creates a text file (c:\test.txt) and then
writes some text to the file (the variable f is an instance of the TextStream
object):

<%  dim fs, f  set fs=Server.CreateObject("Scripting.FileSystemObject")  set f=fs.CreateTextFile("c:\test.txt",true)  f.WriteLine("Hello World!") f.Close set f=nothing set fs=nothing %>

To create an instance of the TextStream object you can use the
CreateTextFile or OpenTextFile methods of the FileSystemObject object, or you
can use the OpenAsTextStream method of the File object.

The TextStream object's properties and methods are described
below:

Properties

Property	Description
AtEndOfLine	Returns true if the file pointer is positioned immediately before the end-of-line marker in a TextStream file, and false if not
AtEndOfStream	Returns true if the file pointer is at the end of a TextStream file, and false if not
Column	Returns the column number of the current character position in an input stream
Line	Returns the current line number in a TextStream file

Methods

Method	Description
Close	Closes an open TextStream file
Read	Reads a specified number of characters from a TextStream file and returns the result
ReadAll	Reads an entire TextStream file and returns the result
ReadLine	Reads one line from a TextStream file and returns the result
Skip	Skips a specified number of characters when reading a TextStream file
SkipLine	Skips the next line when reading a TextStream file
Write	Writes a specified text to a TextStream file
WriteLine	Writes a specified text and a new-line character to a TextStream file
WriteBlankLines	Writes a specified number of new-line character to a TextStream file

---