TextReader.Read Метод

Определение

Пространство имен:

System.IO

Сборка:

System.Runtime.dll

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

Перегрузки

Read()	Выполняет чтение следующего символа из средства чтения текста и перемещает положение символа на одну позицию вперед.
Read(Span<Char>)	Считывает символы из текущего потока чтения и записывает данные в указанный буфер.
Read(Char[], Int32, Int32)	Считывает указанное максимальное количество символов из текущего средства чтения и записывает данные в буфер, начиная с заданного индекса.

Read()

Исходный код:

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()
• Read()
• Файловый и потоковый ввод-вывод
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл

Read(Span<Char>)

Исходный код:

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

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

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 разделе метод .

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

• Read(Char[], Int32, Int32)
• Read(Char[], Int32, Int32)
• Файловый и потоковый ввод-вывод
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл