ЧтениеДанных / DataReader

Объект предназначен для чтения различных типов данных из источника данных. В качестве источника могут выступать Поток, Файл или ДвоичныеДанные. Необходимо соблюдать следующий порядок работы с данным объектом:

Свойства

КодировкаТекста / TextEncoding

Доступ: Чтение/Запись

Кодировка текста, используемая по-умолчанию для данного экземпляра ЧтениеДанных. Кодировка может быть задана как в виде значения перечисления КодировкаТекста, так и в виде строки с указанием названия кодировки.

КонвертируемыйРазделительСтрок / ConvertibleSplitterOfLines

Доступ: Чтение/Запись

Тип значения: Строка (String)

Конвертируемый разделитель строк. Этот параметр влияет на поведение метода ПрочитатьСимволы.

ПорядокБайтов / ByteOrder

Доступ: Чтение/Запись

Тип значения: ПорядокБайтов (ByteOrder)

Порядок байтов по умолчанию.

РазделительСтрок / LineSplitter

Доступ: Чтение/Запись

Тип значения: Строка (String)

Разделитель строк по-умолчанию. Это свойство влияет на поведение метода ПрочитатьСтроку.

ЧтениеЗавершено / ReadCompleted

Доступ: Чтение

Тип значения: Булево (Boolean)

Содержит признак того, что во входном потоке больше нет данных для чтения. Изначально устанавливается в значение Ложь. Если при очередном чтении было прочитано меньше данных, чем было запрошено, принимает значение Истина.

Методы

Закрыть / Close()

Вызов данного метода завершает работу с текущим объектом. Если объект является владельцем вложенного потока, поток также закрывается.

ИсходныйПоток / SourceStream()

Получает исходный поток, из которого выполняется чтение данных.

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

Пропустить / Skip()

Пропускает при чтении указанное количество байтов в потоке.

Параметры

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

ПропуститьДо / SkipTo()

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

Параметры

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

Прочитать / Read()

Выполняет чтение двоичных данных заданного размера из потока. Если размер не указан, будут прочитаны все данные до конца потока.

Параметры

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

Содержит описание результата чтения данных из потока.

ПрочитатьБайт / ReadByte()

Выполняет чтение одного байта из потока.

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

Число или Неопределено, если не удалось прочитать байт, поскольку был достигнут конец потока.

ПрочитатьВБуферДвоичныхДанных / ReadIntoBinaryDataBuffer()

Прочитать байты из потока в БуферДвоичныхДанных.

Параметры

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

ПрочитатьДо / ReadTo()

Выполняет чтение двоичных данных до указанного маркера.

Параметры

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

Содержит описание результата чтения данных из потока.

ПрочитатьСимволы / ReadChars()

Выполняет чтение заданного количества символов из потока в виде строки. Если количество символов не задано, выполняется чтение всего остатка потока.

Параметры

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

ПрочитатьСтроку / ReadLine()

Выполняет чтение строки текста до разделителя строки. Если разделитель не найден, чтение выполняется до конца потока. Если разделитель строки не задан явно, используется разделитель строки, указанный для данного экземпляра объекта ЧтениеДанных.

Параметры

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

ПрочитатьЦелое16 / ReadInt16()

Считывает 16-битное целое число из потока.

Параметры

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

Число или Неопределено, если не удалось прочитать число, поскольку был достигнут конец потока.

ПрочитатьЦелое32 / ReadInt32()

Считывает 32-битное целое число из потока.

Параметры

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

Число или Неопределено, если не удалось прочитать число, поскольку был достигнут конец потока.

ПрочитатьЦелое64 / ReadInt64()

Считывает 64-битное целое число из потока.

Параметры

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

Число или Неопределено, если не удалось прочитать число, поскольку был достигнут конец потока.

Разделить / Split()

Разделяет остаток данных по заданным разделителям.

Параметры

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

Разделить / Split()

Разделяет остаток данных по заданным разделителям.

Параметры

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

РазделитьНаЧастиПо / SplitInPartsOf()

Разделяет остаток данных на части заданного размера. Размер части указывается в байтах.

Параметры

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

Конструкторы

На основании двоичных данных или имени файла

Создает объект для чтения из заданного объекта ДвоичныеДанные. После завершения работы с объектом ЧтениеДанных до того, как будет закрыт поток, переданный в конструктор, объект следует закрыть с помощью метода Закрыть или НачатьЗакрытие.

Параметры

Значение по умолчанию: UTF8. Типы: КодировкаТекста (TextEncoding), Строка (String)