StringReader.ReadLine Метод

Определение

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

System.IO

Сборки:

netstandard.dll, 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, 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.

Если строка заканчивается новой последовательностью, возвращается дополнительная пустая строка. Например, строка "line1\nline2\n" создает те же две строки ("line1" и "line2") как строку "line1\nline2".

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

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

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

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

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