ReadText

Syntax

string = streamobject.ReadText [(NumBytes)]

Description

Reads the specified number of bytes from a text Stream object andreturns the data as a string.

The ReadText method is used to read an entire text file or a specified number of characters from a Stream object and to return the data as a string.

This method is used exclusively for text data type Stream objects. Please use the similar Read method for binary data type Stream objects.

There is one optional parameter.

Parameter	Description
NumBytes	The optional NumBytes parameter is either the number of characters to read or one of the StreamReadEnum constants. If you specify a number larger than the actual number of characters available in the Stream, only the actual available characters are read and no error is generated. A null value is returned if there are no characters left to be read.

StreamReadEnum Constants

Constant	Value	Description
adReadAll	-1	Default, read from the current position to EOS
adReadLine	-2	Only read until the end of the current line

See Also

Type, Read.

Example

Dim strStreamText

strStreamText = objStream.ReadText adReadAll

Dim intNumChars, strStreamText

intNumChars = 1000

...

strStreamText = objStream.ReadText intNumChars