Асинхронная функция. Выполняет чтение заданного количества байтов в указанный буфер по указанному смещению. Текущая позиция смещается вперед на фактическое количество прочитанных байтов. Чтение из потока возможно только, если поток поддерживает чтение. В противном случае, будет вызвано исключение. При чтении размер целевого буфера не меняется, а его содержимое перезаписывается фактически прочитанными данными. Если в буфере недостаточно места для записи прочитанных данных, происходит ошибка переполнения.
Синтаксис
ПрочитатьАсинх(<Буфер>, <ПозицияВБуфере>, <Количество>)Полное описание, параметры и ограничения
Поток.ПрочитатьАсинх (Stream.ReadAsync)
Поток (Stream)
ПрочитатьАсинх (ReadAsync)
Доступен, начиная с версии 8.3.18.
Синтаксис:
ПрочитатьАсинх(<Буфер>, <ПозицияВБуфере>, <Количество>)
Параметры:
<Буфер> (обязательный)
Тип: БуферДвоичныхДанных.
Буфер, в который выполняется чтение.
<ПозицияВБуфере> (обязательный)
Тип: Число.
Позиция в целевом буфере, начиная с которой требуется записывать данные из потока.
<Количество> (обязательный)
Тип: Число.
Количество байтов, которые требуется записать в целевой буфер.
Возвращаемое значение:
Тип: Обещание.
Результат выполнения обещания - фактически прочитанное кол-во байтов типа Число. Может быть меньше, чем запрошенное, если достигнут конец потока.
Описание:
Асинхронная функция. Выполняет чтение заданного количества байтов в указанный буфер по указанному смещению. Текущая позиция смещается вперед на фактическое количество прочитанных байтов.
Чтение из потока возможно только, если поток поддерживает чтение. В противном случае, будет вызвано исключение.
При чтении размер целевого буфера не меняется, а его содержимое перезаписывается фактически прочитанными данными. Если в буфере недостаточно места для записи прочитанных данных, происходит ошибка переполнения.
Доступность:
Тонкий клиент, веб-клиент, толстый клиент.
См. также:
Поток, метод НачатьЧтение
Поток, метод Прочитать
Использование в версии:
Доступен, начиная с версии 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.
Ждать завершил обещания до извлечения копии и до закрытия источника.
Ожидаемый результат
Завершена последовательная цепочка обещаний базового потока без доступа к диску.
На что обратить внимание
ПрочитатьАсинх также может вернуть меньше запрошенного: всегда используйте результат ожидания.
Не начинайте одновременно несколько действий над разделяющими позицию видами.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.