ADO: ActiveX Data Objects

Name

Stream.Position Property — (Versions 2.5, 2.6)

Synopsis

                     stream.Position = number
                  

The Position property indicates the position of the stream pointer within the Stream object.

Datatype

Long

Description

The Position property can be set to any positive number or 0. It can also be set to a value greater than the size of the current Stream object. In doing so, for streams with write permissions you may increase the size of a Stream object by automatically adding Null values. You can, although you are not advised to, do the same for read-only streams, but the size is not altered.

The Position property indicates the number of bytes the stream pointer is located away from the first byte in the stream. If your character set contains multiple bytes for each character, you must multiply this number by the position desired to get the actual character position. For example, when using Unicode, 0 represents the first character, and 2 represents the second.