StringReader.ReadLine Метод

Определение

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

System.IO

Сборка:

System.Runtime.dll

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

StringReader.cs

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

public:
 override System::String ^ ReadLine();

public override string? ReadLine ();

override this.ReadLine : unit -> string

Public Overrides Function ReadLine () As String

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

String

Следующая строка из текущей строки, или значение null, если достигнут конец строки.

Исключения

ObjectDisposedException

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

OutOfMemoryException

Не хватает памяти для выделения буфера под возвращаемую строку.

Примеры

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

// From textReaderText, create a continuous paragraph 
// with two spaces between each sentence.
   String^ aLine;
String^ aParagraph;
StringReader^ strReader = gcnew StringReader( textReaderText );
while ( true )
{
   aLine = strReader->ReadLine();
   if ( aLine != nullptr )
   {
      aParagraph = String::Concat( aParagraph, aLine,  " " );
   }
   else
   {
      aParagraph = String::Concat( aParagraph,  "\n" );
      break;
   }
}

Console::WriteLine(  "Modified text:\n\n{0}", aParagraph );

// From textReaderText, create a continuous paragraph
// with two spaces between each sentence.
string aLine, aParagraph = null;
StringReader strReader = new StringReader(textReaderText);
while(true)
{
    aLine = strReader.ReadLine();
    if(aLine != null)
    {
        aParagraph = aParagraph + aLine + " ";
    }
    else
    {
        aParagraph = aParagraph + "\n";
        break;
    }
}
Console.WriteLine("Modified text:\n\n{0}", aParagraph);

' From textReaderText, create a continuous paragraph 
' with two spaces between each sentence.
Dim aLine, aParagraph As String
Dim strReader As New StringReader(textReaderText)
While True
    aLine = strReader.ReadLine()
    If aLine Is Nothing Then
        aParagraph = aParagraph & vbCrLf
        Exit While
    Else
        aParagraph = aParagraph & aLine & " "
    End If
End While
Console.WriteLine("Modified text:" & vbCrLf & vbCrLf & _ 
    aParagraph)

Комментарии

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

Строка определяется как последовательность символов, за которой следует перевод строки ("\n"), возврат каретки ("\r"), возврат каретки, за которым сразу же следует перевод строки ("\r\n") или маркер конца потока. Возвращаемая строка не содержит завершающего возврата каретки или перевода строки. Возвращаемое значение равно , null если достигнут маркер конца потока. То есть, если между последней прочитанной строкой и маркером конца потока нет ничего, метод возвращает null.

Если текущий метод выдает исключение , позиция читателя в базовой OutOfMemoryExceptionстроке двигается на количество символов, которые метод смог прочитать, но символы, уже прочитанные во внутренний ReadLine буфер, удаляются. Поскольку положение средства чтения в строке изменить невозможно, уже прочитанные символы не восстанавливаются и доступны только путем повторной инициализации StringReader. Чтобы избежать такой ситуации Read , используйте метод и сохраните символы чтения в предварительно размещенном буфере.

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

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

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

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