ТекстовыйДокумент (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.

     Методическая информация