StringReader.ReadLine StringReader.ReadLine StringReader.ReadLine StringReader.ReadLine Method

Определение

Выполняет чтение строки символов из текущей строки и возвращает данные в виде строки.Reads a line of characters from the current string and returns the data as a string.

public:
 override System::String ^ ReadLine();
public override string ReadLine ();
override this.ReadLine : unit -> string
Public Overrides Function ReadLine () As String

Возвраты

Следующая строка из текущей строки, или null при достижении конца строки.The next line from the current string, or null if the end of the string is reached.

Исключения

Текущее средство чтения закрыто.The current reader is closed.

Не хватает памяти для выделения буфера под возвращаемую строку.There is insufficient memory to allocate a buffer for the returned string.

Примеры

Данный пример кода является частью большего примера для StringReader класса.This code example is part of a larger example provided for the StringReader class.

// 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 метод.This method overrides the TextReader.ReadLine method.

Строка определяется как последовательность символов, последующим символом перевода строки («\n»), символ возврата каретки («\r»), символ возврата каретки сразу следуют символом перевода строки («\r\n») или маркер окончания потока.A line is defined as a sequence of characters followed by a line feed ("\n"), a carriage return ("\r"), a carriage return immediately followed by a line feed ("\r\n"), or the end-of-stream marker. Возвращаемая строка содержит завершающий символ возврата каретки или перевода строки.The string that is returned does not contain the terminating carriage return or line feed. Возвращаемое значение — null если достигнут конец потока маркер.The returned value is null if the end-of-stream marker has been reached. Именно, если нет ничего между последней строки операции чтения и маркер окончания потока, метод возвращает null.That is to say, if there is nothing between the last line read and the end-of-stream marker, the method returns null.

Если текущий метод вызывает OutOfMemoryException, позиция средства чтения в основной строке увеличивается на число знаков, которое может читать метод, но знаки, уже считанные во внутренний ReadLine буфера, отбрасываются.If the current method throws an OutOfMemoryException, the reader's position in the underlying string is advanced by the number of characters the method was able to read, but the characters already read into the internal ReadLine buffer are discarded. Поскольку невозможно изменить позицию средства чтения в строке, символами, считанными уже неустранимой и может осуществляться только при повторной инициализации StringReader.Because the position of the reader in the string cannot be changed, the characters already read are unrecoverable, and can be accessed only by reinitializing the StringReader. Чтобы избежать такой ситуации, используйте Read метод и хранилищем чтения знаки в предварительно выделенной буфере.To avoid such a situation, use the Read method and store the read characters in a preallocated buffer.

В следующей таблице перечислены примеры других типичных и связанных задач ввода-вывода.The following table lists examples of other typical or related I/O tasks.

ДействиеTo do this... Раздел с примеромSee the example in this topic...
Создание текстового файла.Create a text file. Практическое руководство. Запись текста в файлHow to: Write Text to a File
Запись в текстовый файл.Write to a text file. Практическое руководство. Запись текста в файлHow to: Write Text to a File
Чтение из текстового файла.Read from a text file. Практическое руководство. Чтение текста из файлаHow to: Read Text from a File
Добавление текста в файл.Append text to a file. Практическое руководство. Открытие файла журнала и добавление в него данныхHow to: Open and Append to a Log File

File.AppendText

FileInfo.AppendText
Возвращает размер файла.Get the size of a file. FileInfo.Length
Получение атрибутов файла.Get the attributes of a file. File.GetAttributes
Задайте атрибуты файла.Set the attributes of a file. File.SetAttributes
Определите, существует ли файл.Determine if a file exists. File.Exists
Чтение из двоичного файла.Read from a binary file. Практическое руководство. Считывание данных из нового файла и запись в этот файлHow to: Read and Write to a Newly Created Data File
Запись в двоичный файл.Write to a binary file. Практическое руководство. Считывание данных из нового файла и запись в этот файлHow to: Read and Write to a Newly Created Data File

Применяется к

Дополнительно