Асинхронная функция. Считывает текстовый документ из файла.
Синтаксис
ПрочитатьАсинх(<ИмяФайла>, <ТипФайла>, <РазделительСтрок>)ПрочитатьАсинх(<Поток>, <ТипФайла>, <РазделительСтрок>)Полное описание, параметры и ограничения
ТекстовыйДокумент.ПрочитатьАсинх (TextDocument.ReadAsync)
ТекстовыйДокумент (TextDocument)
ПрочитатьАсинх (ReadAsync)
Доступен, начиная с версии 8.3.18.
Вариант синтаксиса: Из файла
Синтаксис:
ПрочитатьАсинх(<ИмяФайла>, <ТипФайла>, <РазделительСтрок>)
Параметры:
<ИмяФайла> (обязательный)
Тип: Строка.
Имя текстового файла.
<ТипФайла> (необязательный)
Тип: КодировкаТекста, Строка.
Указывается кодировка текста в открываемом файле.
В случае, если параметр не задан, формат текста будет определен автоматически (если он хранится в файле с сигнатурой BOM в начале). Если автоматически определить формат файла не удается, файл будет открыт в кодировке UTF8.
Тип файла может быть задан как в виде значения перечисления КодировкаТекста, так и в виде строки с указанием названия кодировки.
Поддерживаемые названия кодировок:
UTF-8
UTF-16
UTF-16BE
UTF-16LE
ISO-8859-1
US-ASCII
gb18030
iso-8859-2
iso-8859-3
iso-8859-4
iso-8859-5
iso-8859-6
iso-8859-7
iso-8859-8
iso-8859-9
iso-8859-13
iso-8859-15
Shift_JIS
EUC-JP
Big5
Big5-HKSCS
GBK
GB2312
GB_2312-80
EUC-KR
KSC_5601
windows-949
windows-874
cp866
KOI8-R
KOI8-U
windows-1250
windows-1251
windows-1252
windows-1253
windows-1254
windows-1255
windows-1256
windows-1257
windows-1258
macintosh
x-mac-cyrillic
ISO-2022-JP
ISO-2022-KR
ISO-2022-CN
ISO-2022-CN-EXT
HZ-GB-2312
<РазделительСтрок> (необязательный)
Тип: Строка.
Задается строка, являющаяся разделителем строк, из которой при чтении файла будет сформирован символ ПС.
Если строка пустая, то разделители строк при чтении не конвертируются.
Допустимые варианты разделителей строк:
ВК;
ПС;
ВК + ПС (значение по умолчанию - может не указываться).
При использовании других строк в качестве разделителей будет вызвано исключение.
Значение по умолчанию: ВК + ПС.
Описание варианта метода:
Считывает текстовый документ из файла.
Вариант синтаксиса: Из потока
Синтаксис:
ПрочитатьАсинх(<Поток>, <ТипФайла>, <РазделительСтрок>)
Параметры:
<Поток> (обязательный)
Тип: Поток, ПотокВПамяти, ФайловыйПоток.
Поток для чтения.
<ТипФайла> (необязательный)
Тип: КодировкаТекста, Строка.
Указывается кодировка текста в потоке.
В случае, если параметр не задан, формат текста будет определен автоматически (если он хранится в файле с сигнатурой BOM в начале). Если автоматически определить формат файла не удается, файл будет открыт в кодировке UTF8.
Тип файла может быть задан как в виде значения перечисления КодировкаТекста, так и в виде строки с указанием названия кодировки.
Поддерживаемые названия кодировок:
UTF-8
UTF-16
UTF-16BE
UTF-16LE
ISO-8859-1
US-ASCII
gb18030
iso-8859-2
iso-8859-3
iso-8859-4
iso-8859-5
iso-8859-6
iso-8859-7
iso-8859-8
iso-8859-9
iso-8859-13
iso-8859-15
Shift_JIS
EUC-JP
Big5
Big5-HKSCS
GBK
GB2312
GB_2312-80
EUC-KR
KSC_5601
windows-949
windows-874
cp866
KOI8-R
KOI8-U
windows-1250
windows-1251
windows-1252
windows-1253
windows-1254
windows-1255
windows-1256
windows-1257
windows-1258
macintosh
x-mac-cyrillic
ISO-2022-JP
ISO-2022-KR
ISO-2022-CN
ISO-2022-CN-EXT
HZ-GB-2312
<РазделительСтрок> (необязательный)
Тип: Строка.
Задается строка, являющаяся разделителем строк, из которой при чтении потока будет сформирован символ ПС.
Если строка пустая, то разделители строк при чтении не конвертируются.
Допустимые варианты разделителей строк:
ВК;
ПС;
ВК + ПС (значение по умолчанию - может не указываться).
При использовании других строк в качестве разделителей будет вызвано исключение.
Значение по умолчанию: ВК + ПС.
Описание варианта метода:
Считывает текстовый документ из потока.
Возвращаемое значение:
Тип: Обещание.
Результат выполнения обещания - Неопределено.
Описание:
Асинхронная функция. Считывает текстовый документ из файла.
Доступность:
Тонкий клиент, толстый клиент.
См. также:
ТекстовыйДокумент, метод Прочитать
ТекстовыйДокумент, метод НачатьЧтение
Использование в версии:
Доступен, начиная с версии 8.3.18.
Методическая информация
Практические примеры
Асинхронно записать две русские строки в память и прочитать их обратно
Согласовываем кодировку UTF-8 и разделитель ПС, ожидаем обе операции и проверяем содержимое строк, не результат обещания записи как Булево.
Где и как запускать
Модуль пустой управляемой формы учебной внешней обработки; тонкий или толстый клиент Windows. Вставьте весь модуль. Это не серверный код.
Подготовка
Создайте учебную внешнюю обработку с пустой управляемой основной формой. Создайте команду УчебныйПример и кнопку этой команды.
В свойстве команды Действие выберите процедуру УчебныйПример. Вставьте полный приведённый модуль формы.
Откройте EPF в тонком или толстом клиенте Windows и нажмите кнопку. Не переносите Ждать и Асинх в серверный общий модуль.
Пример работает только со своими данными в памяти; записи в базу, файлы и сеть нет.
&НаКлиенте
Асинх Процедура УчебныйПример(Команда)
Исходный = Новый ТекстовыйДокумент;
Исходный.УстановитьТекст("Книга" + Символы.ПС + "Ручка");
ПотокЗаписи = Новый ПотокВПамяти;
Попытка
Ждать Исходный.ЗаписатьАсинх(ПотокЗаписи, КодировкаТекста.UTF8, Символы.ПС, Ложь);
Исключение
ПотокЗаписи.Закрыть();
ВызватьИсключение;
КонецПопытки;
Данные = ПотокЗаписи.ЗакрытьИПолучитьДвоичныеДанные();
Сообщить(Данные.Размер() > 0);
ПотокЧтения = Данные.ОткрытьПотокДляЧтения();
Копия = Новый ТекстовыйДокумент;
Попытка
Ждать Копия.ПрочитатьАсинх(ПотокЧтения, КодировкаТекста.UTF8, Символы.ПС);
Исключение
ПотокЧтения.Закрыть();
ВызватьИсключение;
КонецПопытки;
ПотокЧтения.Закрыть();
Сообщить(Копия.КоличествоСтрок() = Исходный.КоличествоСтрок());
Сообщить(Копия.ПолучитьСтроку(1) = "Книга");
Сообщить(Копия.ПолучитьСтроку(2) = "Ручка");
КонецПроцедурыРазбор по шагам
Исходный документ содержит две русские строки. Экспортируем в свой поток, а не в файл.
Перегрузка ЗаписатьАсинх в поток позволяет явно указать ЗаписатьBOM=Ложь.
Закрытие и извлечение ДвоичныеДанные выполняется только ПОСЛЕ Ждать записи.
Для чтения открываем другой поток из готовых данных и ожидаем ПрочитатьАсинх в той же кодировке.
ПрочитатьАсинх заполняет сам объект Копия; результат обещания — Неопределено, не новый ТекстовыйДокумент.
Поток чтения принадлежит нашему коду и закрывается явно после операции.
Как проверить результат
Все четыре сравнения Истина: байты непустые, число строк совпало, восстановлены Книга и Ручка.
Повторный запуск не дописывает старые данные и не создаёт файлов.
Ожидаемый результат
Выполнен законченный асинхронный круговой обмен текстового документа через байты в памяти.
На что обратить внимание
Не присваивайте Копия = Ждать Копия.ПрочитатьАсинх(...): вы затрёте объект значением Неопределено.
Отсутствие BOM требует согласованной явной кодировки. Не полагайтесь на угадывание кириллицы.
Не закрывайте поток, пока операция ожидается; пользовательское скачивание в браузере этим примером не проверяется.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.