ТекстовыйДокумент.ЗаписатьАсинх (TextDocument.WriteAsync)

ТекстовыйДокумент (TextDocument)

ЗаписатьАсинх (WriteAsync)

Доступен, начиная с версии 8.3.18.

Вариант синтаксиса: В файл

Синтаксис:

ЗаписатьАсинх(<ИмяФайла>, <ТипФайла>, <РазделительСтрок>)

Параметры:

<ИмяФайла> (обязательный)

Тип: Строка.
Имя файла для сохранения текста.

<ТипФайла> (необязательный)

Тип: КодировкаТекста, Строка.
Тип кодировки файла. Тип файла может быть задан как в виде значения перечисления КодировкаТекста, так и в виде строки с указанием названия кодировки.
Поддерживаемые названия кодировок:

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

Значение по умолчанию: UTF8.

<РазделительСтрок> (необязательный)

Тип: Строка.
Задается строка, являющаяся разделителем строк, к которой при записи файла будет преобразован символ ПС. Если строка пустая, то разделители строк при записи не конвертируются.
Допустимые варианты разделителей строк:

ВК;
ПС;
ВК + ПС (значение по умолчанию - может не указываться).

При использовании других строк в качестве разделителей будет вызвано исключение.
Значение по умолчанию: ВК + ПС.

Описание варианта метода:

Запись текстового документа в файл.

Вариант синтаксиса: В поток

Синтаксис:

ЗаписатьАсинх(<Поток>, <ТипФайла>, <РазделительСтрок>, <ЗаписатьBOM>)

Параметры:

<Поток> (обязательный)

Тип: Поток, ПотокВПамяти, ФайловыйПоток.
Поток для записи документа.

<ТипФайла> (необязательный)

Тип: КодировкаТекста, Строка.
Тип кодировки текста. Тип кодировки может быть задан как в виде значения перечисления КодировкаТекста, так и в виде строки с указанием названия кодировки.
Поддерживаемые названия кодировок:

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

Значение по умолчанию: UTF8.

<РазделительСтрок> (необязательный)

Тип: Строка.
Задается строка, являющаяся разделителем строк, из которой при чтении файла будет сформирован символ ПС.
Если строка пустая, то разделители строк при чтении не конвертируются.
Допустимые варианты разделителей строк:

ВК;
ПС;
ВК + ПС (значение по умолчанию - может не указываться).

<ЗаписатьBOM> (необязательный)

Тип: Булево.
Определяет, будет ли добавлена метка порядка байт (BOM) при сохранении документа.
Значение по умолчанию: Ложь.

Описание варианта метода:

Запись текстового документа в поток.

Возвращаемое значение:

Тип: Обещание.
Результат выполнения обещания:

Истина - если запись была инициирована с помощью расширения браузера и пользователь согласился на его получение, то есть запись файла была завершена.
Ложь - если запись была инициирована с помощью расширения браузера, но пользователь не согласился на его получение, то есть запись файла не была завершена.
Неопределено - если запись была инициирована скачиванием файла средствами браузера и неизвестно, был ли файл записан или нет.

Описание:

Асинхронная функция. Записывает текст в файл с именем <ИмяФайла>.

Доступность:

Тонкий клиент, веб-клиент, толстый клиент.

См. также:

ТекстовыйДокумент, метод Записать
ТекстовыйДокумент, метод НачатьЗапись

Использование в версии:

Доступен, начиная с версии 8.3.18.

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