TextReader.Read Метод

  • Ссылка

Определение

Пространство имен:
System.IO
Сборка:
System.IO.dll
Сборка:
System.Runtime.dll
Сборка:
System.Runtime.Extensions.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll

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

Перегрузки

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

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

Int32

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

Исключения

ObjectDisposedException

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

IOException

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

Комментарии

Класс 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>

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

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

Int32

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

Исключения

ArgumentNullException

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

IOException

Количество символов, считанных из потока, превышает длину 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

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

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

Int32

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

Исключения

ArgumentNullException

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

ArgumentException

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

ArgumentOutOfRangeException

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

ObjectDisposedException

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

IOException

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

Комментарии

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

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

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

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