ФайловыйПоток.ПерейтиАсинх (FileStream.SeekAsync)

ФайловыйПоток (FileStream)

ПерейтиАсинх (SeekAsync)

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

Синтаксис:

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

Параметры:

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

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

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

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

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

Тип: Обещание.
Результат выполнения обещания - позиция типа Число.

Описание:

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

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

Тонкий клиент, веб-клиент, толстый клиент.

Примечание:

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

См. также:

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

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

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

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