Свойство Position (ADO)

Указывает текущее положение в объекте Stream .

Параметры и возвращаемые значения

Задает или возвращает значение Long , указывающее смещение (в количестве байтов) текущей позиции от начала потока. Значение по умолчанию — 0, представляющее первый байт в потоке.

Комментарии

Текущую позицию можно переместить в точку после окончания потока. Если указать текущую позицию после конца потока, размер объекта Stream будет увеличен соответствующим образом. Все новые байты, добавленные таким образом, будут иметь значение NULL.

Примечание

Position всегда измеряет байты. Для текстовых потоков, использующих многобайтовые кодировки, умножьте положение на размер символа, чтобы определить номер символа. Например, для двухбайтовой кодировки первый символ находится в позиции 0, второй — в позиции 2, третий — в позиции 4 и т. д.

Примечание

Отрицательные значения нельзя использовать для изменения текущей позиции в потоке. Для позиции можно использовать только положительные числа.

Примечание

Для объектов Stream , доступных только для чтения, ADO не возвращает ошибку, если для параметра Position задано значение, превышающее размерпотока. При этом размер потока или содержимое потока не изменяются каким-либо образом. Однако этого следует избегать, так как это приводит к бессмысленнойпозиции.

Применение

Объект Stream (ADO)

См. также:

Свойство Charset (ADO)