Поток.Перейти (Stream.Seek)

Поток (Stream)

Перейти (Seek)

Доступен, начиная с версии 8.3.9.

Синтаксис:

Перейти(<Смещение>, <НачальнаяПозиция>)

Параметры:

<Смещение> (обязательный)

Тип: Число.
Количество байтов, на которое нужно передвинуть позицию в потоке.

<НачальнаяПозиция> (необязательный)

Тип: ПозицияВПотоке.
Начальная позиция, от которой отсчитывается смещение.

Возвращаемое значение:

Тип: Число.
Новая позиция в потоке.

Описание:

Сдвигает текущую позицию потока на заданное количество байтов относительно начальной позиции. Если указано отрицательное смещение, позиция сдвигается в направлении к началу потока.
Если изменение позиции недоступно (ДоступноИзменениеПозиции установлено в Ложь), будет сгенерировано исключение.

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер, интеграция.

Примечание:

Если результирующая позиция меньше 0, будет сгенерировано исключение.
После записи в поток за пределами текущего размера, размер потока соответствующим образом увеличивается, а все байты после старого размера потока и до новой позиции остаются в неопределенном состоянии.

См. также:

Поток, метод НачатьПереход
Поток, метод ПерейтиАсинх

Использование в версии:

Доступен, начиная с версии 8.3.9.

Описание изменено в версии 8.3.18.

Методическая информация