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