интеграция ozone, права доступа УТ 11, отчёт на СКД

ЧтениеДанных.ПрочитатьСимволыАсинх

Методы · ReadCharsAsync

Асинхронная функция. Читает заданное количество символов из потока в виде строки. Если количество не задано, то весь остататок потока читается в виде строки.

Синтаксис

ПрочитатьСимволыАсинх(<Количество>, <Кодировка>)
Полное описание, параметры и ограничения

ЧтениеДанных.ПрочитатьСимволыАсинх (DataReader.ReadCharsAsync)

ЧтениеДанных (DataReader)

ПрочитатьСимволыАсинх (ReadCharsAsync)

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

Синтаксис:
ПрочитатьСимволыАсинх(<Количество>, <Кодировка>)
Параметры:

<Количество> (необязательный)
Тип: Число.
Количество символов, которые требуется прочитать. Если не установлено, то будут прочитаны все символы до конца потока.
Значение по умолчанию: Неопределено.

<Кодировка> (необязательный)
Тип: КодировкаТекста, Строка.
Определяет кодировку текста. Если не установлена, используется кодировка, заданная для данного объекта ЧтениеДанных.
Кодировка может быть задана как в виде значения перечисления КодировкаТекста, так и в виде строки с указанием названия кодировки.
Поддерживаемые названия кодировок:
Adobe-Standard-Encoding - не поддерживается в веб-клиенте,

Big5 - не поддерживается в веб-клиенте,

Big5-HKSCS - не поддерживается в веб-клиенте,

BOCU-1 - не поддерживается в веб-клиенте,

CESU-8 - не поддерживается в веб-клиенте,

cp1006 - не поддерживается в веб-клиенте,

cp1025 - не поддерживается в веб-клиенте,

cp1097 - не поддерживается в веб-клиенте,

cp1098 - не поддерживается в веб-клиенте,

cp1112 - не поддерживается в веб-клиенте,

cp1122 - не поддерживается в веб-клиенте,

cp1123 - не поддерживается в веб-клиенте,

cp1124 - не поддерживается в веб-клиенте,

cp1125 - не поддерживается в веб-клиенте,

cp1131 - не поддерживается в веб-клиенте,

cp1386 - не поддерживается в веб-клиенте,

cp33722 - не поддерживается в веб-клиенте,

cp437 - не поддерживается в веб-клиенте,

cp737 - не поддерживается в веб-клиенте,

cp775 - не поддерживается в веб-клиенте,

cp850 - не поддерживается в веб-клиенте,

cp851 - не поддерживается в веб-клиенте,

cp852 - не поддерживается в веб-клиенте,

cp855 - не поддерживается в веб-клиенте,

cp856 - не поддерживается в веб-клиенте,

cp857 - не поддерживается в веб-клиенте,

cp858 - не поддерживается в веб-клиенте,

cp860 - не поддерживается в веб-клиенте,

cp861 - не поддерживается в веб-клиенте,

cp862 - не поддерживается в веб-клиенте,

cp863 - не поддерживается в веб-клиенте,

cp864 - не поддерживается в веб-клиенте,

cp865 - не поддерживается в веб-клиенте,

cp866 - не поддерживается в веб-клиенте,

CP868 - не поддерживается в веб-клиенте,

cp869 - не поддерживается в веб-клиенте,

cp874

cp875 - не поддерживается в веб-клиенте,

cp922 - не поддерживается в веб-клиенте,

cp930 - не поддерживается в веб-клиенте,

cp932 - не поддерживается в веб-клиенте,

cp933 - не поддерживается в веб-клиенте,

cp935 - не поддерживается в веб-клиенте,

cp937 - не поддерживается в веб-клиенте,

cp939 - не поддерживается в веб-клиенте,

cp949 - не поддерживается в веб-клиенте,

cp949c - не поддерживается в веб-клиенте,

cp950 - не поддерживается в веб-клиенте,

cp964 - не поддерживается в веб-клиенте,

ebcdic-ar - не поддерживается в веб-клиенте,

ebcdic-de - не поддерживается в веб-клиенте,

ebcdic-dk - не поддерживается в веб-клиенте,

ebcdic-he - не поддерживается в веб-клиенте,

ebcdic-xml-us - не поддерживается в веб-клиенте.

EUC-JP - не поддерживается в веб-клиенте,

EUC-KR - не поддерживается в веб-клиенте,

GB_2312-80 - не поддерживается в веб-клиенте,

gb18030 - не поддерживается в веб-клиенте,

GB2312 - не поддерживается в веб-клиенте,

GBK - не поддерживается в веб-клиенте,

hp-roman8 - не поддерживается в веб-клиенте,

HZ-GB-2312 - не поддерживается в веб-клиенте,

ibm-1047_P100-1995,swaplfnl - не поддерживается в веб-клиенте,

ibm-1129 - не поддерживается в веб-клиенте,

ibm-1130 - не поддерживается в веб-клиенте,

ibm-1132 - не поддерживается в веб-клиенте,

ibm-1133 - не поддерживается в веб-клиенте,

ibm-1137 - не поддерживается в веб-клиенте,

ibm-1140_P100-1997,swaplfnl - не поддерживается в веб-клиенте,

ibm-1142_P100-1997,swaplfnl - не поддерживается в веб-клиенте,

ibm-1143_P100-1997,swaplfnl - не поддерживается в веб-клиенте,

ibm-1144_P100-1997,swaplfnl - не поддерживается в веб-клиенте,

ibm-1145_P100-1997,swaplfnl - не поддерживается в веб-клиенте,

ibm-1146_P100-1997,swaplfnl - не поддерживается в веб-клиенте,

ibm-1147_P100-1997,swaplfnl - не поддерживается в веб-клиенте,

ibm-1148_P100-1997,swaplfnl - не поддерживается в веб-клиенте,

ibm-1149_P100-1997,swaplfnl - не поддерживается в веб-клиенте,

ibm-1153 - не поддерживается в веб-клиенте,

ibm-1153_P100-1999,swaplfnl - не поддерживается в веб-клиенте,

ibm-1154 - не поддерживается в веб-клиенте,

ibm-1155 - не поддерживается в веб-клиенте,

ibm-1156 - не поддерживается в веб-клиенте,

ibm-1157 - не поддерживается в веб-клиенте,

ibm-1158 - не поддерживается в веб-клиенте,

ibm-1160 - не поддерживается в веб-клиенте,

ibm-1162 - не поддерживается в веб-клиенте,

ibm-1164 - не поддерживается в веб-клиенте,

ibm-12712_P100-1998,swaplfnl - не поддерживается в веб-клиенте,

ibm-1363 - не поддерживается в веб-клиенте,

ibm-1364 - не поддерживается в веб-клиенте,

ibm-1371 - не поддерживается в веб-клиенте,

ibm-1388 - не поддерживается в веб-клиенте,

ibm-1390 - не поддерживается в веб-клиенте,

ibm-1399 - не поддерживается в веб-клиенте,

ibm-16684 - не поддерживается в веб-клиенте,

ibm-16804_X110-1999,swaplfnl - не поддерживается в веб-клиенте,

ibm-37_P100-1995,swaplfnl - не поддерживается в веб-клиенте,

ibm-4899 - не поддерживается в веб-клиенте,

ibm-4909 - не поддерживается в веб-клиенте,

ibm-4971 - не поддерживается в веб-клиенте,

ibm-5123 - не поддерживается в веб-клиенте,

ibm-803 - не поддерживается в веб-клиенте,

ibm-8482 - не поддерживается в веб-клиенте,

ibm-867 - не поддерживается в веб-клиенте,

ibm-901 - не поддерживается в веб-клиенте,

ibm-902 - не поддерживается в веб-клиенте,

ibm-971 - не поддерживается в веб-клиенте,

IBM-Thai - не поддерживается в веб-клиенте,

IBM01140 - не поддерживается в веб-клиенте,

IBM01141 - не поддерживается в веб-клиенте,

IBM01142 - не поддерживается в веб-клиенте,

IBM01143 - не поддерживается в веб-клиенте,

IBM01144 - не поддерживается в веб-клиенте,

IBM01145 - не поддерживается в веб-клиенте,

IBM01146 - не поддерживается в веб-клиенте,

IBM01147 - не поддерживается в веб-клиенте,

IBM01148 - не поддерживается в веб-клиенте,

IBM01149 - не поддерживается в веб-клиенте,

IBM037 - не поддерживается в веб-клиенте,

IBM1026 - не поддерживается в веб-клиенте,

IBM1047 - не поддерживается в веб-клиенте,

IBM278 - не поддерживается в веб-клиенте,

IBM280 - не поддерживается в веб-клиенте,

IBM284 - не поддерживается в веб-клиенте,

IBM285 - не поддерживается в веб-клиенте,

IBM290 - не поддерживается в веб-клиенте,

IBM297 - не поддерживается в веб-клиенте,

IBM367 ,

IBM420 - не поддерживается в веб-клиенте,

IBM424 - не поддерживается в веб-клиенте,

IBM500 - не поддерживается в веб-клиенте,

IBM870 - не поддерживается в веб-клиенте,

IBM871 - не поддерживается в веб-клиенте,

IBM918 - не поддерживается в веб-клиенте,

IMAP-mailbox-name - не поддерживается в веб-клиенте,

ISO_2022,locale=ja,version=3 - не поддерживается в веб-клиенте,

ISO_2022,locale=ja,version=4 - не поддерживается в веб-клиенте,

ISO_2022,locale=ko,version=1 - не поддерживается в веб-клиенте,

ISO-2022-CN - не поддерживается в веб-клиенте,

ISO-2022-CN-EXT - не поддерживается в веб-клиенте,

ISO-2022-JP - не поддерживается в веб-клиенте,

ISO-2022-JP-2 - не поддерживается в веб-клиенте,

ISO-2022-KR - не поддерживается в веб-клиенте,

ISO-8859-1 ,

iso-8859-13 ,

iso-8859-15 ,

iso-8859-2 ,

iso-8859-3 ,

iso-8859-4 ,

iso-8859-5 ,

iso-8859-6 ,

iso-8859-7 ,

iso-8859-8 ,

iso-8859-9 ,

JIS_Encoding - не поддерживается в веб-клиенте,

KOI8-R ,

KOI8-U ,

KSC_5601 - не поддерживается в веб-клиенте,

LMBCS-1 - не поддерживается в веб-клиенте,

LMBCS-11 - не поддерживается в веб-клиенте,

LMBCS-16 - не поддерживается в веб-клиенте,

LMBCS-17 - не поддерживается в веб-клиенте,

LMBCS-18 - не поддерживается в веб-клиенте,

LMBCS-19 - не поддерживается в веб-клиенте,

LMBCS-2 - не поддерживается в веб-клиенте,

LMBCS-3 - не поддерживается в веб-клиенте,

LMBCS-4 - не поддерживается в веб-клиенте,

LMBCS-5 - не поддерживается в веб-клиенте,

LMBCS-6 - не поддерживается в веб-клиенте,

LMBCS-8 - не поддерживается в веб-клиенте,

macintosh ,

SCSU - не поддерживается в веб-клиенте,

Shift_JIS - не поддерживается в веб-клиенте,

UTF-16 ,

UTF-16BE ,

UTF-16LE ,

UTF-32 - не поддерживается в веб-клиенте,

UTF-32BE - не поддерживается в веб-клиенте,

UTF-32LE - не поддерживается в веб-клиенте,

UTF-7 - не поддерживается в веб-клиенте,

UTF-8 ,

UTF16_OppositeEndian - не поддерживается в веб-клиенте,

UTF16_PlatformEndian - не поддерживается в веб-клиенте,

UTF32_OppositeEndian - не поддерживается в веб-клиенте,

UTF32_PlatformEndian - не поддерживается в веб-клиенте,

windows-1250 - не поддерживается в веб-клиенте,

windows-1251 ,

windows-1252 ,

windows-1253 ,

windows-1254 ,

windows-1255 ,

windows-1256 ,

windows-1257 ,

windows-1258 ,

windows-57002 - не поддерживается в веб-клиенте,

windows-57003 - не поддерживается в веб-клиенте,

windows-57004 - не поддерживается в веб-клиенте,

windows-57005 - не поддерживается в веб-клиенте,

windows-57007 - не поддерживается в веб-клиенте,

windows-57008 - не поддерживается в веб-клиенте,

windows-57009 - не поддерживается в веб-клиенте,

windows-57010 - не поддерживается в веб-клиенте,

windows-57011 - не поддерживается в веб-клиенте,

windows-874 - не поддерживается в веб-клиенте,

windows-949 - не поддерживается в веб-клиенте,

windows-950 - не поддерживается в веб-клиенте,

x-mac-centraleurroman - не поддерживается в веб-клиенте,

x-mac-cyrillic ,

x-mac-greek - не поддерживается в веб-клиенте,

x-mac-turkish - не поддерживается в веб-клиенте,

Значение по умолчанию: Неопределено.
Возвращаемое значение:
Тип: Обещание.
Результат выполнения обещания - Строка, содержащая прочитанные символы.
Описание:

Асинхронная функция. Читает заданное количество символов из потока в виде строки. Если количество не задано, то весь остататок потока читается в виде строки.

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

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

Примечание:
Если при чтении находятся строки, заданные параметром КонвертируемыйРазделительСтрок, они преобразуются к стандартному разделителю ПС.
Если КонвертируемыйРазделительСтрок не задан, то используется значение по умолчанию: ВК + ПС.
См. также:
ЧтениеДанных, метод НачатьЧтениеСимволов
ЧтениеДанных, метод ПрочитатьСимволы
ЧтениеДанных, метод Прочитать

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

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

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

Практические примеры

Асинхронно пропустить служебную часть и прочитать поле до границы

Разбираем HDR|Книга#TAIL: сначала пропуск байтов и границы, затем получение поля и хвоста с обработкой отсутствующего маркера.

Где и как запускать

Модуль пустой управляемой формы учебной внешней обработки; тонкий или толстый клиент Windows. Вставьте весь модуль. Это не серверный код.

Подготовка

  1. Создайте учебную внешнюю обработку с пустой управляемой основной формой. Создайте команду УчебныйПример и кнопку этой команды.

  2. В свойстве команды Действие выберите процедуру УчебныйПример. Вставьте полный приведённый модуль формы.

  3. Откройте EPF в тонком или толстом клиенте Windows и нажмите кнопку. Не переносите Ждать и Асинх в серверный общий модуль.

  4. Пример работает только со своими данными в памяти; записи в базу, файлы и сеть нет.

&НаКлиенте
Асинх Процедура УчебныйПример(Команда)
    Данные = ПолучитьДвоичныеДанныеИзСтроки("HDR|Книга#TAIL", КодировкаТекста.UTF8, Ложь);
    Чтение = Новый ЧтениеДанных(Данные, КодировкаТекста.UTF8);
    Попытка
        Пропущено = Ждать Чтение.ПропуститьАсинх(3);
        Если Пропущено <> 3 Тогда
            ВызватьИсключение "Учебный заголовок неполный";
        КонецЕсли;
        Граница = Ждать Чтение.ПропуститьДоАсинх("|", КодировкаТекста.UTF8);
        Если Граница = -1 Тогда
            ВызватьИсключение "Обязательная граница не найдена";
        КонецЕсли;
        Поле = Ждать Чтение.ПрочитатьДоАсинх("#", КодировкаТекста.UTF8);
        Если Не Поле.МаркерНайден Тогда
            ВызватьИсключение "Не найдена граница поля";
        КонецЕсли;
        Двоичные = Ждать Поле.ПолучитьДвоичныеДанныеАсинх();
        Сообщить(Граница = 0);
        Сообщить(ПолучитьСтрокуИзДвоичныхДанных(Двоичные, КодировкаТекста.UTF8) = "Книга");
        Хвост = Ждать Чтение.ПрочитатьСимволыАсинх();
        Сообщить(Хвост = "TAIL");
        НетГраницы = Ждать Чтение.ПропуститьДоАсинх("|", КодировкаТекста.UTF8);
        Сообщить(НетГраницы = -1);
        Ждать Чтение.ЗакрытьАсинх();
    Исключение
        Чтение.Закрыть();
        ВызватьИсключение;
    КонецПопытки;
КонецПроцедуры

Разбор по шагам

  1. Ждать ПропуститьАсинх возвращает фактическое число байтов, а не признак успеха.

  2. Обязательную границу | ищем только после проверки полного трёхбайтового заголовка.

  3. Результат ПропуститьДоАсинх с одним найденным маркером равен 0. При отсутствии возвращается -1.

  4. ПрочитатьДоАсинх даёт РезультатЧтенияДанных. Проверяем его МаркерНайден перед преобразованием текстового поля.

  5. TAIL читается после #; повторный поиск | на конце подтверждает отсутствие маркера.

Как проверить результат

  1. Получены Книга и TAIL; успешный индекс 0, неуспешный -1; четыре сообщения Истина.

  2. Измените первый разделитель на /: пример прекращает разбор с понятной ошибкой, а не объявляет сообщение корректным.

Ожидаемый результат

Учебное сообщение разобрано асинхронно с явными проверками границ.

На что обратить внимание

  1. Пропуск трёх байтов подходит именно для ASCII-заголовка HDR.

  2. Ошибки обязательных границ нельзя скрывать и продолжать разбор как будто сообщение корректно.

  3. Пример не осуществляет HTTP-запрос и не является спецификацией внешнего протокола.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Асинхронно записать две строки и прочитать строку и остаток

ЗаписьСимволов не добавляет границу, ЗаписьСтроки добавляет ПС. После чтения первой строки отдельным вызовом забираем оставшиеся символы.

Где и как запускать

Модуль пустой управляемой формы учебной внешней обработки; тонкий или толстый клиент Windows. Вставьте весь модуль. Это не серверный код.

Подготовка

  1. Создайте учебную внешнюю обработку с пустой управляемой основной формой. Создайте команду УчебныйПример и кнопку этой команды.

  2. В свойстве команды Действие выберите процедуру УчебныйПример. Вставьте полный приведённый модуль формы.

  3. Откройте EPF в тонком или толстом клиенте Windows и нажмите кнопку. Не переносите Ждать и Асинх в серверный общий модуль.

  4. Пример работает только со своими данными в памяти; записи в базу, файлы и сеть нет.

&НаКлиенте
Асинх Процедура УчебныйПример(Команда)
    Поток = Новый ПотокВПамяти;
    Запись = Новый ЗаписьДанных(Поток, КодировкаТекста.UTF8, , Символы.ПС);
    Попытка
        Ждать Запись.ЗаписатьСтрокуАсинх("Книга");
        Ждать Запись.ЗаписатьСимволыАсинх("Ручка");
        Ждать Запись.ЗакрытьАсинх();
    Исключение
        Запись.Закрыть();
        Поток.Закрыть();
        ВызватьИсключение;
    КонецПопытки;
    Данные = Поток.ЗакрытьИПолучитьДвоичныеДанные();
    Чтение = Новый ЧтениеДанных(Данные, КодировкаТекста.UTF8, , Символы.ПС);
    Попытка
        Сообщить(Чтение.РазделительСтрок = Символы.ПС);
        ПерваяСтрока = Ждать Чтение.ПрочитатьСтрокуАсинх();
        Остаток = Ждать Чтение.ПрочитатьСимволыАсинх();
        Сообщить(ПерваяСтрока = "Книга");
        Сообщить(Остаток = "Ручка");
        Ждать Чтение.ЗакрытьАсинх();
    Исключение
        Чтение.Закрыть();
        ВызватьИсключение;
    КонецПопытки;
КонецПроцедуры

Разбор по шагам

  1. Конструкторы явно используют UTF-8 и разделитель ПС. BOM не добавляется по умолчанию.

  2. Первый ожидаемый вызов пишет Книга и ПС, второй — только пять букв Ручка без добавленного ПС.

  3. После закрытия записи создаём новое чтение полученных данных.

  4. ПрочитатьСтрокуАсинх возвращает после Ждать строку Книга без разделителя, а ПрочитатьСимволыАсинх — остаток Ручка.

  5. Все объекты локальны одному запуску: повторный клик не переиспользует чужую позицию чтения.

Как проверить результат

  1. Все три сравнения Истина; первая строка Книга, остаток Ручка.

  2. Повторный запуск выдаёт такой же результат и не создаёт файлов.

Ожидаемый результат

Получены именно строки, а не объекты обещаний; граница между записями сохранена.

На что обратить внимание

  1. Не вставляйте клиентскую Асинх процедуру внутрь другой процедуры.

  2. Успешная запись в память не означает отправку в сервис или сохранение в базу.

  3. При работе с текстом всегда согласовывайте кодировку обеих сторон.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Связанные темы

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу
1c-only | Фриланс © 2026
Политика обработки персональных данных · Пользовательское соглашение
1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.