StringReader.Read Метод

Определение

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

System.IO

Сборка:

System.Runtime.dll

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

Перегрузки

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

Read()

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

StringReader.cs

Считывает следующий символ из строки ввода и увеличивает позицию символа на один символ.

public:
 override int Read();

public override int Read ();

override this.Read : unit -> int

Public Overrides Function Read () As Integer

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

Int32

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

Исключения

ObjectDisposedException

Текущее средство чтения закрыто.

Примеры

Этот пример входит в состав более крупного примера использования класса StringReader.

convertedCharacter = Convert::ToChar( intCharacter );
if ( convertedCharacter == '.' )
{
   strWriter->Write(  ".\n\n" );
   
   // Bypass the spaces between sentences.
   strReader->Read();
   strReader->Read();
}

convertedCharacter = (char)intCharacter;
if(convertedCharacter == '.')
{
    strWriter.Write(".\n\n");

    // Bypass the spaces between sentences.
    strReader.Read();
    strReader.Read();
}

convertedCharacter = Convert.ToChar(intCharacter)
If convertedCharacter = "."C Then
    strWriter.Write("." & vbCrLf & vbCrLf)

    ' Bypass the spaces between sentences.
    strReader.Read()
    strReader.Read()

Комментарии

Этот метод переопределяет TextReader.Read метод .

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

Действие	Раздел с примером
Создание текстового файла.	Практическое руководство. Запись текста в файл
Запись в текстовый файл.	Практическое руководство. Запись текста в файл
Чтение из текстового файла.	Практическое руководство. Чтение текста из файла
Добавление текста в файл.	Практическое руководство. Открытие файла журнала и добавление в него данных File.AppendText FileInfo.AppendText
Получение размера файла.	FileInfo.Length
Получение атрибутов файла.	File.GetAttributes
Задайте атрибуты файла.	File.SetAttributes
Определите, существует ли файл.	File.Exists
Чтение из двоичного файла.	Практическое руководство. Считывание данных из нового файла и запись в этот файл
Запись в двоичный файл.	Практическое руководство. Считывание данных из нового файла и запись в этот файл

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

• Файловый и потоковый ввод-вывод
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл

Read(Span<Char>)

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

StringReader.cs

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

public:
 override int Read(Span<char> buffer);

public override int Read (Span<char> buffer);

override this.Read : Span<char> -> int

Public Overrides Function Read (buffer As Span(Of Char)) As Integer

Параметры

buffer

Span<Char>

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

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

Int32

Общее количество символов, считанных в буфер.

Исключения

ObjectDisposedException

Текущий экземпляр обработчика строки закрыт.

Read(Char[], Int32, Int32)

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

StringReader.cs

Считывает блок символов из строки ввода и увеличивает позицию символов на count.

public:
 override int Read(cli::array <char> ^ buffer, int index, int count);

public override int Read (char[] buffer, int index, int count);

override this.Read : char[] * int * int -> int

Public Overrides Function Read (buffer As Char(), index As Integer, count As Integer) As Integer

Параметры

buffer

Char[]

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

index

Int32

Начальный индекс в буфере.

count

Int32

Количество символов, которые необходимо считать.

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

Int32

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

Исключения

ArgumentNullException

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

ArgumentException

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

ArgumentOutOfRangeException

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

ObjectDisposedException

Текущее средство чтения закрыто.

Комментарии

Этот метод переопределяет метод TextReader.Read.

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

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

Действие	Раздел с примером
Создание текстового файла.	Практическое руководство. Запись текста в файл
Запись в текстовый файл.	Практическое руководство. Запись текста в файл
Чтение из текстового файла.	Практическое руководство. Чтение текста из файла
Добавление текста в файл.	Практическое руководство. Открытие файла журнала и добавление в него данных File.AppendText FileInfo.AppendText
Получение размера файла.	FileInfo.Length
Получение атрибутов файла.	File.GetAttributes
Задайте атрибуты файла.	File.SetAttributes
Определите, существует ли файл.	File.Exists
Чтение из двоичного файла.	Практическое руководство. Считывание данных из нового файла и запись в этот файл
Запись в двоичный файл.	Практическое руководство. Считывание данных из нового файла и запись в этот файл

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

• Файловый и потоковый ввод-вывод
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл