Read Method (ADO)

Microsoft ActiveX Data Objects (ADO)

ADO 2.5 API Reference

Read Method

Reads a specified number of bytes from a binary Stream object.

Syntax

Variant = Stream.Read ( NumBytes )

Parameters

NumBytes
Optional. A Long value that specifies the number of bytes to read from the file or the StreamReadEnum value adReadAll, which is the default.

Return Value

The Read method reads a specified number of bytes or the entire stream from a Stream object and returns the resulting data as a Variant.

Remarks

If NumBytes is more than the number of bytes left in the Stream, only the bytes remaining are returned. The data read is not padded to match the length specified by NumBytes. If there are no bytes left to read, a variant with a null value is returned. Read cannot be used to read backwards.

Note   NumBytes always measures bytes. For text Stream objects (Type is adTypeText), use ReadText.

See Also

Example

ReadText Method

Applies To: Stream Object

© 1998-2003 Microsoft Corporation. All rights reserved.