Асинхронная функция. Сдвигает текущую позицию потока на заданное количество байтов относительно начальной позиции. Если указано отрицательное смещение, позиция сдвигается в направлении к началу потока. Если изменение позиции недоступно (ДоступноИзменениеПозиции установлено в Ложь), будет сгенерировано исключение.
Синтаксис
ПерейтиАсинх(<Смещение>, <НачальнаяПозиция>)Полное описание, параметры и ограничения
Поток.ПерейтиАсинх (Stream.SeekAsync)
Поток (Stream)
ПерейтиАсинх (SeekAsync)
Доступен, начиная с версии 8.3.18.
Синтаксис:
ПерейтиАсинх(<Смещение>, <НачальнаяПозиция>)
Параметры:
<Смещение> (обязательный)
Тип: Число.
Количество байтов, на которое нужно передвинуть позицию в потоке.
<НачальнаяПозиция> (необязательный)
Тип: ПозицияВПотоке.
Начальная позиция, от которой отсчитывается смещение.
Возвращаемое значение:
Тип: Обещание.
Результат выполнения обещания - позиция типа Число.
Описание:
Асинхронная функция. Сдвигает текущую позицию потока на заданное количество байтов относительно начальной позиции. Если указано отрицательное смещение, позиция сдвигается в направлении к началу потока.
Если изменение позиции недоступно (ДоступноИзменениеПозиции установлено в Ложь), будет сгенерировано исключение.
Доступность:
Тонкий клиент, веб-клиент, толстый клиент.
Примечание:
Если результирующая позиция меньше 0, будет сгенерировано исключение.
После записи в поток за пределами текущего размера, размер потока соответствующим образом увеличивается, а все байты после старого размера потока и до новой позиции остаются в неопределенном состоянии.
См. также:
Поток, метод Перейти
Поток, метод НачатьПереход
Использование в версии:
Доступен, начиная с версии 8.3.18.
Методическая информация
Практические примеры
Дождаться чтения и копирования базового readonly-потока
В клиентском обработчике ожидаем фактические числа от обещаний. Исходник ABC123 только в памяти; файлов и сетевых запросов нет.
Где и как запускать
Модуль пустой управляемой формы учебной внешней обработки; тонкий или толстый клиент Windows. Вставьте весь модуль. Это не серверный код.
Подготовка
Создайте учебную внешнюю обработку с пустой управляемой основной формой. Создайте команду УчебныйПример и кнопку этой команды.
В свойстве команды Действие выберите процедуру УчебныйПример. Вставьте полный приведённый модуль формы.
Откройте EPF в тонком или толстом клиенте Windows и нажмите кнопку. Не переносите Ждать и Асинх в серверный общий модуль.
Пример работает только со своими данными в памяти; записи в базу, файлы и сеть нет.
&НаКлиенте
Асинх Процедура УчебныйПример(Команда)
Данные = ПолучитьДвоичныеДанныеИзСтроки("ABC123", КодировкаТекста.UTF8, Ложь);
Поток = Данные.ОткрытьПотокДляЧтения();
Вид = Неопределено;
Копия = Неопределено;
Попытка
Размер = Ждать Поток.РазмерАсинх();
Сообщить(Размер = 6);
Позиция = Ждать Поток.ПерейтиАсинх(2, ПозицияВПотоке.Начало);
Сообщить(Позиция = 2);
Буфер = Новый БуферДвоичныхДанных(2);
Количество = Ждать Поток.ПрочитатьАсинх(Буфер, 0, 2);
Сообщить(Количество = 2);
Сообщить(ПолучитьСтрокуИзБуфераДвоичныхДанных(Буфер, КодировкаТекста.UTF8) = "C1");
Копия = Новый ПотокВПамяти;
КоличествоКопии = Ждать Поток.КопироватьВАсинх(Копия);
Сообщить(КоличествоКопии = 2);
Хвост = Копия.ЗакрытьИПолучитьДвоичныеДанные();
Копия = Неопределено;
Сообщить(ПолучитьСтрокуИзДвоичныхДанных(Хвост, КодировкаТекста.UTF8) = "23");
Ждать Поток.ЗакрытьАсинх();
Исключение
Если Вид <> Неопределено Тогда
Вид.Закрыть();
КонецЕсли;
Если Копия <> Неопределено Тогда
Копия.Закрыть();
КонецЕсли;
Поток.Закрыть();
ВызватьИсключение;
КонецПопытки;
Если Вид <> Неопределено Тогда
Вид.Закрыть();
КонецЕсли;
Если Копия <> Неопределено Тогда
Копия.Закрыть();
КонецЕсли;
Поток.Закрыть();
КонецПроцедурыРазбор по шагам
Полный модуль &НаКлиенте / Асинх Процедура запускается кнопкой в учебной форме Windows.
После ожидания позиции 2 читаем C1, курсор становится 4.
Копирование от текущей позиции получает только последние 23, не весь ABC123.
Закрытие ожидаем после завершения всех чтений. Повторное синхронное Закрыть в общей очистке допустимо по контракту.
Как проверить результат
Шесть сравнений Истина: 6, 2, чтение 2/C1 и копирование 2/23.
Ждать завершил обещания до извлечения копии и до закрытия источника.
Ожидаемый результат
Завершена последовательная цепочка обещаний базового потока без доступа к диску.
На что обратить внимание
ПрочитатьАсинх также может вернуть меньше запрошенного: всегда используйте результат ожидания.
Не начинайте одновременно несколько действий над разделяющими позицию видами.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.