Асинхронная функция. Дальнейшая работа с объектом после вызова этого метода невозможна. Если объект является владельцем нижележащего потока, то поток также закрывается.
Синтаксис
ЗакрытьАсинх()Полное описание, параметры и ограничения
ЧтениеДанных.ЗакрытьАсинх (DataReader.CloseAsync)
ЧтениеДанных (DataReader)
ЗакрытьАсинх (CloseAsync)
Доступен, начиная с версии 8.3.18.
Синтаксис:
ЗакрытьАсинх()
Возвращаемое значение:
Тип: Обещание.
Результат выполнения обещания - Неопределено.
Описание:
Асинхронная функция. Дальнейшая работа с объектом после вызова этого метода невозможна. Если объект является владельцем нижележащего потока, то поток также закрывается.
Доступность:
Тонкий клиент, толстый клиент.
См. также:
ЧтениеДанных, метод Закрыть
ЧтениеДанных, метод НачатьЗакрытие
Использование в версии:
Доступен, начиная с версии 8.3.18.
Методическая информация
Практические примеры
Асинхронно перенести срез буфера и обработать неполное чтение
Из ABCDEFG переносим CDE, затем читаем один байт в новый буфер и остаток в заранее выделенную область.
Где и как запускать
Модуль пустой управляемой формы учебной внешней обработки; тонкий или толстый клиент Windows. Вставьте весь модуль. Это не серверный код.
Подготовка
Создайте учебную внешнюю обработку с пустой управляемой основной формой. Создайте команду УчебныйПример и кнопку этой команды.
В свойстве команды Действие выберите процедуру УчебныйПример. Вставьте полный приведённый модуль формы.
Откройте EPF в тонком или толстом клиенте Windows и нажмите кнопку. Не переносите Ждать и Асинх в серверный общий модуль.
Пример работает только со своими данными в памяти; записи в базу, файлы и сеть нет.
&НаКлиенте
Асинх Процедура УчебныйПример(Команда)
ИсходныйБуфер = ПолучитьБуферДвоичныхДанныхИзСтроки("ABCDEFG", КодировкаТекста.UTF8, Ложь);
Поток = Новый ПотокВПамяти;
Запись = Новый ЗаписьДанных(Поток);
Попытка
Ждать Запись.ЗаписатьБуферДвоичныхДанныхАсинх(ИсходныйБуфер, 2, 3);
Ждать Запись.ЗакрытьАсинх();
Исключение
Запись.Закрыть();
Поток.Закрыть();
ВызватьИсключение;
КонецПопытки;
Данные = Поток.ЗакрытьИПолучитьДвоичныеДанные();
Сообщить(ПолучитьСтрокуИзДвоичныхДанных(Данные, КодировкаТекста.UTF8) = "CDE");
Чтение = Новый ЧтениеДанных(Данные);
Попытка
НовыйБуфер = Ждать Чтение.ПрочитатьВБуферДвоичныхДанныхАсинх(1);
Сообщить(ПолучитьСтрокуИзБуфераДвоичныхДанных(НовыйБуфер, КодировкаТекста.UTF8) = "C");
Существующий = ПолучитьБуферДвоичныхДанныхИзСтроки(".....", КодировкаТекста.UTF8, Ложь);
Прочитано = Ждать Чтение.ПрочитатьВБуферДвоичныхДанныхАсинх(Существующий, 1, 3);
Сообщить(Прочитано = 2);
Сообщить(ПолучитьСтрокуИзБуфераДвоичныхДанных(Существующий, КодировкаТекста.UTF8) = ".DE..");
Ждать Чтение.ЗакрытьАсинх();
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
КонецПроцедурыРазбор по шагам
Срез записи начинается с нулевого индекса 2, то есть C, и содержит три байта CDE.
Ждать метода записи обеспечивает завершение переноса до закрытия потока.
Перегрузка чтения с количеством 1 возвращает новый буфер C.
Перегрузка с существующим буфером возвращает число, здесь 2: в источнике осталось только DE.
Незаписанные точки остаются прежними данными. Проверяем весь пятибайтовый буфер .DE...
Как проверить результат
Скопировано CDE, первый буфер C, фактически прочитано 2, существующий буфер .DE..; четыре сообщения Истина.
Исходный буфер ABCDEFG не изменяется от записи его среза в другой поток.
Ожидаемый результат
Показаны байтовые смещения и два разных типа результата асинхронных перегрузок.
На что обратить внимание
Количество — байты, не буквы. Исходный набор ASCII делает смещения однозначными.
Диапазон записи должен находиться внутри буфера; пример не расширяет его за пределы размера.
Не сравнивайте Обещание с числом 2: сначала получите фактический результат через Ждать.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Асинхронно скопировать непрочитанное тело в свой поток
В собственном наборе HDRBODY пропускаем заголовок и ожидаем копирование оставшихся четырёх байтов.
Где и как запускать
Модуль пустой управляемой формы учебной внешней обработки; тонкий или толстый клиент Windows. Вставьте весь модуль. Это не серверный код.
Подготовка
Создайте учебную внешнюю обработку с пустой управляемой основной формой. Создайте команду УчебныйПример и кнопку этой команды.
В свойстве команды Действие выберите процедуру УчебныйПример. Вставьте полный приведённый модуль формы.
Откройте EPF в тонком или толстом клиенте Windows и нажмите кнопку. Не переносите Ждать и Асинх в серверный общий модуль.
Пример работает только со своими данными в памяти; записи в базу, файлы и сеть нет.
&НаКлиенте
Асинх Процедура УчебныйПример(Команда)
Данные = ПолучитьДвоичныеДанныеИзСтроки("HDRBODY", КодировкаТекста.UTF8, Ложь);
Чтение = Новый ЧтениеДанных(Данные);
Целевой = Новый ПотокВПамяти;
Попытка
Пропущено = Ждать Чтение.ПропуститьАсинх(3);
Если Пропущено <> 3 Тогда
ВызватьИсключение "Учебный заголовок неполный";
КонецЕсли;
Скопировано = Ждать Чтение.КопироватьВАсинх(Целевой);
Сообщить(Скопировано = 4);
Ждать Чтение.ЗакрытьАсинх();
Исключение
Чтение.Закрыть();
Целевой.Закрыть();
ВызватьИсключение;
КонецПопытки;
Тело = Целевой.ЗакрытьИПолучитьДвоичныеДанные();
Сообщить(ПолучитьСтрокуИзДвоичныхДанных(Тело, КодировкаТекста.UTF8) = "BODY");
КонецПроцедурыРазбор по шагам
Создаём независимые источник и приёмник; оба принадлежат только этому запуску.
Ждать ПропуститьАсинх продвигает позицию на три байта. Проверяем фактическое количество.
Ждать КопироватьВАсинх возвращает количество скопированных байтов, а не поток и не текст.
Закрываем чтение, получаем данные из собственного приёмника и декодируем их явно.
Как проверить результат
Скопировано 4, восстановлен BODY; оба сравнения Истина.
Заголовок HDR не попадает в приёмник и файлы не создаются.
Ожидаемый результат
Получено тело сообщения без предварительного чтения остатка в строку.
На что обратить внимание
Не закрывайте целевой поток, пока ожидаемое копирование не завершено.
Операция переносит остаток, а не все исходные данные от начала.
Это память, не загрузка на сервер и не сохранение файла.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.