Read Method (ADO)

Microsoft ActiveX Data Objects (ADO)

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, use ReadText.