Поделиться через


TextReader.Read Метод

Определение

Считывает данные из средства чтения текста.

Перегрузки

Read()

Выполняет чтение следующего символа из средства чтения текста и перемещает положение символа на одну позицию вперед.

Read(Span<Char>)

Считывает символы из текущего потока чтения и записывает данные в указанный буфер.

Read(Char[], Int32, Int32)

Считывает указанное максимальное количество символов из текущего средства чтения и записывает данные в буфер, начиная с заданного индекса.

Read()

Исходный код:
TextReader.cs
Исходный код:
TextReader.cs
Исходный код:
TextReader.cs

Выполняет чтение следующего символа из средства чтения текста и перемещает положение символа на одну позицию вперед.

public:
 virtual int Read();
public virtual int Read ();
abstract member Read : unit -> int
override this.Read : unit -> int
Public Overridable Function Read () As Integer

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

Следующий символ из средства чтения текста или значение -1, если доступных символов больше нет. Реализация по умолчанию возвращает значение -1.

Исключения

Объект TextReader закрыт.

Ошибка ввода-вывода.

Комментарии

Класс TextReader представляет собой абстрактный класс. Следовательно, в коде экземпляр этого объекта не создается. Пример использования Read метода см. в StreamReader.Read разделе метод .

См. также раздел

Применяется к

Read(Span<Char>)

Исходный код:
TextReader.cs
Исходный код:
TextReader.cs
Исходный код:
TextReader.cs

Считывает символы из текущего потока чтения и записывает данные в указанный буфер.

public:
 virtual int Read(Span<char> buffer);
public virtual int Read (Span<char> buffer);
abstract member Read : Span<char> -> int
override this.Read : Span<char> -> int
Public Overridable Function Read (buffer As Span(Of Char)) As Integer

Параметры

buffer
Span<Char>

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

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

Количество считанных символов. Это число будет не больше длины buffer в зависимости от доступности данных в потоке чтения. Этот метод возвращает 0 (ноль), если его вызвать при отсутствии символов, доступных для чтения.

Исключения

buffer имеет значение null.

Количество символов, считанных из потока, превышает длину buffer.

Применяется к

Read(Char[], Int32, Int32)

Исходный код:
TextReader.cs
Исходный код:
TextReader.cs
Исходный код:
TextReader.cs

Считывает указанное максимальное количество символов из текущего средства чтения и записывает данные в буфер, начиная с заданного индекса.

public:
 virtual int Read(cli::array <char> ^ buffer, int index, int count);
public virtual int Read (char[] buffer, int index, int count);
abstract member Read : char[] * int * int -> int
override this.Read : char[] * int * int -> int
Public Overridable Function Read (buffer As Char(), index As Integer, count As Integer) As Integer

Параметры

buffer
Char[]

При возвращении из этого метода содержит указанный массив символов, в котором значения в интервале от index и (index + count - 1) заменены символами, считанными из текущего источника.

index
Int32

Позиция в буфере buffer, с которого начинается запись.

count
Int32

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

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

Количество считанных символов. Количество будет меньше или равно count в зависимости от доступности данных в средстве чтения. Этот метод возвращает 0 (ноль), если его вызвать при отсутствии символов, доступных для чтения.

Исключения

buffer имеет значение null.

Длина буфера минус index меньше count.

index или count является отрицательным значением.

Объект TextReader закрыт.

Ошибка ввода-вывода.

Комментарии

Этот метод возвращает значение после считывания символов count или достижения конца файла. ReadBlock — это блокирующая версия этого метода.

Класс TextReader представляет собой абстрактный класс. Следовательно, в коде экземпляр этого объекта не создается. Пример использования Read метода см. в StreamReader.Read разделе метод .

См. также раздел

Применяется к