Тип: Булево. Содержит признак того, что во входном потоке больше нет данных для чтения. Изначально устанавливается в значение Ложь. Если при очередном чтении было прочитано меньше данных, чем было запрошено, принимает значение Истина.
Полное описание, параметры и ограничения
ЧтениеДанных.ЧтениеЗавершено (DataReader.ReadCompleted)
ЧтениеДанных (DataReader)
ЧтениеЗавершено (ReadCompleted)
Доступен, начиная с версии 8.3.9.
Использование:
Только чтение.
Описание:
Тип: Булево.
Содержит признак того, что во входном потоке больше нет данных для чтения. Изначально устанавливается в значение Ложь. Если при очередном чтении было прочитано меньше данных, чем было запрошено, принимает значение Истина.
Доступность:
Тонкий клиент, веб-клиент, сервер, толстый клиент, внешнее соединение.
Примечание:
Значение данного свойство можно ипользовать в качестве выхода из цикла при чтении в цикле.
Использование в версии:
Доступен, начиная с версии 8.3.9.
Методическая информация
Практические примеры
Прочитать данные в новый буфер и в часть заранее выделенного буфера
Два варианта одного метода возвращают разные результаты: новый буфер либо фактическое число записанных в существующий буфер байтов.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Используйте отдельную учебную базу. Фрагмент без директив вставьте в тело серверной процедуры ВыполнитьПример() Экспорт общего модуля УчебныеЗадачи.
Все исходные байты создаются самим примером в памяти. Файлы, сеть, справочники и документы не нужны.
Запускайте задачи отдельно. После закрытия ЧтениеДанных/ЗаписьДанных не используйте этот экземпляр повторно.
Данные = ПолучитьДвоичныеДанныеИзСтроки("ABCDE", КодировкаТекста.UTF8, Ложь);
Чтение = Новый ЧтениеДанных(Данные, КодировкаТекста.UTF8);
Попытка
Начало = Чтение.ПрочитатьВБуферДвоичныхДанных(2);
Сообщить(Начало.Размер = 2);
Сообщить(ПолучитьСтрокуИзБуфераДвоичныхДанных(Начало, КодировкаТекста.UTF8) = "AB");
Буфер = Новый БуферДвоичныхДанных(6);
Для Индекс = 0 По Буфер.Размер - 1 Цикл
Буфер.Установить(Индекс, 46);
КонецЦикла;
Прочитано = Чтение.ПрочитатьВБуферДвоичныхДанных(Буфер, 1, 4);
Сообщить(Прочитано = 3);
Сообщить(Буфер.Размер = 6);
Сообщить(ПолучитьСтрокуИзБуфераДвоичныхДанных(Буфер, КодировкаТекста.UTF8) = ".CDE..");
Сообщить(Чтение.ЧтениеЗавершено);
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Чтение.Закрыть();Разбор по шагам
Первый вариант с числом 2 создаёт новый БуферДвоичныхДанных с байтами AB.
Шестибайтный буфер заранее заполняем точками (ASCII-код 46). Это делает незаполненную область видимой.
Второй вариант передаёт объект буфера, начальную позицию 1 и запрошенное количество 4. Буфер не расширяется автоматически.
В источнике осталось только CDE, поэтому результат второго вызова — число 3. Не трактуйте это число как новый буфер.
Запрошено 4, прочитано 3: установлен флаг завершения. Позиции 0, 4 и 5 остаются точками.
Как проверить результат
Результат первого вызова AB; итоговый существующий буфер .CDE..; его размер остаётся 6.
Фактически прочитано 3, а не 4; все шесть сравнений Истина.
Ожидаемый результат
Разобраны обе перегрузки и безопасное частичное чтение в существующий буфер.
На что обратить внимание
Позиция 1 — второй байт, индексы начинаются с нуля.
Не используйте непрочитанный хвост как новые данные: там остаются прежние байты буфера.
ASCII выбран намеренно. Байтовая порция произвольной длины может разрезать русскую букву UTF-8.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Различить буфер и фактическое количество в двух callback чтения
Из ABCDE сначала читаем AB в новый буфер, затем CDE в заранее подготовленные точки. Одна перегрузка даёт буфер, другая число 3.
Где и как запускать
Модуль пустой управляемой формы учебной внешней обработки; тонкий или толстый клиент Windows. Вставьте весь модуль. Это не серверный код.
Подготовка
Создайте учебную внешнюю обработку с пустой управляемой основной формой. Создайте команду УчебныйПример и кнопку этой команды.
В свойстве команды Действие выберите процедуру УчебныйПример. Вставьте полный приведённый модуль формы.
Откройте EPF в тонком или толстом клиенте Windows и нажмите кнопку. Не переносите Ждать и Асинх в серверный общий модуль.
Пример работает только со своими данными в памяти; записи в базу, файлы и сеть нет.
Перем Выполняется;
&НаКлиенте
Процедура УчебныйПример(Команда)
Если Выполняется = Истина Тогда
Сообщить("Дождитесь завершения предыдущей учебной цепочки");
Возврат;
КонецЕсли;
Данные = ПолучитьДвоичныеДанныеИзСтроки("ABCDE", КодировкаТекста.UTF8, Ложь);
Чтение = Новый ЧтениеДанных(Данные);
Буфер = ПолучитьБуферДвоичныхДанныхИзСтроки("......", КодировкаТекста.UTF8, Ложь);
Состояние = Новый Структура("Чтение,ЧтениеЗакрыто,Буфер", Чтение, Ложь, Буфер);
Выполняется = Истина;
Попытка
Состояние.Чтение.НачатьЧтениеВБуферДвоичныхДанных(ОповещениеДля("ПослеНовогоБуфера", Состояние), 2);
Исключение
ОсвободитьУчебныеРесурсы(Состояние);
Выполняется = Ложь;
ВызватьИсключение;
КонецПопытки;
КонецПроцедуры
&НаКлиенте
Функция ОповещениеДля(ИмяОбработчика, Состояние)
Возврат Новый ОписаниеОповещения(ИмяОбработчика, ЭтотОбъект, Состояние,
"ОшибкаОперации", ЭтотОбъект);
КонецФункции
&НаКлиенте
Процедура ОшибкаОперации(Ошибка, СтандартнаяОбработка, Состояние) Экспорт
ОсвободитьУчебныеРесурсы(Состояние);
Выполняется = Ложь;
СтандартнаяОбработка = Истина;
КонецПроцедуры
&НаКлиенте
Процедура ОсвободитьУчебныеРесурсы(Состояние)
Попытка
Если Не Состояние.ЧтениеЗакрыто Тогда
Состояние.Чтение.Закрыть();
Состояние.ЧтениеЗакрыто = Истина;
КонецЕсли;
Исключение
// Не заменяем первичную ошибку вторичной ошибкой освобождения ресурсов.
КонецПопытки;
КонецПроцедуры
&НаКлиенте
Процедура ПослеНовогоБуфера(НовыйБуфер, Состояние) Экспорт
Сообщить(НовыйБуфер.Размер = 2);
Сообщить(ПолучитьСтрокуИзБуфераДвоичныхДанных(НовыйБуфер, КодировкаТекста.UTF8) = "AB");
Состояние.Чтение.НачатьЧтениеВБуферДвоичныхДанных(ОповещениеДля("ПослеСуществующегоБуфера", Состояние), Состояние.Буфер, 1, 4);
КонецПроцедуры
&НаКлиенте
Процедура ПослеСуществующегоБуфера(РеальноеКоличество, Состояние) Экспорт
Сообщить(РеальноеКоличество = 3);
Сообщить(ПолучитьСтрокуИзБуфераДвоичныхДанных(Состояние.Буфер, КодировкаТекста.UTF8) = ".CDE..");
Сообщить(Состояние.Чтение.ЧтениеЗавершено);
Состояние.Чтение.НачатьЗакрытие(ОповещениеДля("ПослеЗакрытияЧтения", Состояние));
КонецПроцедуры
&НаКлиенте
Процедура ПослеЗакрытияЧтения(Состояние) Экспорт
Состояние.ЧтениеЗакрыто = Истина;
Выполняется = Ложь;
КонецПроцедурыРазбор по шагам
Первый вызов передаёт только количество 2. Callback получает НовыйБуфер, содержащий AB.
Второй вызов передаёт существующий шестибайтный буфер, позицию 1 и запрошенные 4 байта.
В источнике осталось 3, поэтому callback получает число РеальноеКоличество=3, а не сам буфер.
Изменённый объект буфера доступен через Состояние.Буфер: он передавался в операцию и сохранил свою идентичность.
Поскольку прочитано меньше запроса, ЧтениеЗавершено устанавливается в Истина.
Как проверить результат
Новый буфер AB длиной 2; существующий .CDE.. длиной 6; реальное количество 3.
Все пять сообщений Истина, а форма разрешает новый запуск после закрытия.
Ожидаемый результат
Показана реальная разница типов callback-результата у перегрузок одного метода.
На что обратить внимание
Не копируйте сигнатуру ПослеНовогоБуфера для существующего буфера: первый аргумент будет Число.
Не используйте всё запрошенное количество как доказательство успешного полного чтения.
Позиции буфера байтовые и нулевые; остаточные точки не являются вновь прочитанными данными.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.