TextReader.Read Метод

Определение

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

System.IO

Сборки:

netstandard.dll, 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 метода.

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

• System.IO.StreamReader.Read
• System.IO.StringReader.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 метода.

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

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