StringReader.ReadLine Methode

Definition

Liest eine Zeile von Zeichen aus der aktuellen Zeichenkette und gibt die Daten als Zeichenfolge zurück.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

Gibt zurück

Die nächste Zeile der aktuellen Zeichenfolge oder null, wenn das Ende der Zeichenfolge erreicht ist.The next line from the current string, or null if the end of the string is reached.

Ausnahmen

Der aktuelle Reader ist geschlossen.The current reader is closed.

Es ist nicht genügend Speicher vorhanden, um einen Puffer für die zurückgegebene Zeichenfolge zuzuordnen.There is insufficient memory to allocate a buffer for the returned string.

Beispiele

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die StringReader -Klasse bereitgestellt wird.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)

Hinweise

Diese Methode überschreibt die TextReader.ReadLine -Methode.This method overrides the TextReader.ReadLine method.

Eine Zeile wird als Sequenz von Zeichen, gefolgt von einem Zeilenvorschub ("\n"), einem Wagen Rücklauf ("\r"), einem Wagen Rücklauf unmittelbar gefolgt von einem Zeilenvorschub ("\r\n") oder dem Ende des streammarkers definiert.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. Die zurückgegebene Zeichenfolge enthält nicht den abschließenden Wagen Rücklauf oder Zeilenvorschub.The string that is returned does not contain the terminating carriage return or line feed. Der zurückgegebene Wert null ist, wenn der End-of-Stream-Marker erreicht wurde.The returned value is null if the end-of-stream marker has been reached. Das heißt, wenn zwischen dem letzten Lesevorgang und dem Ende des streammarkers nichts besteht, gibt die Methode zurück null.That is to say, if there is nothing between the last line read and the end-of-stream marker, the method returns null.

Wenn die aktuelle Methode einen OutOfMemoryExceptionauslöst, wird die Position des Readers in der zugrunde liegenden Zeichenfolge durch die Anzahl der Zeichen erweitert, die von der Methode gelesen werden konnten, aber die bereits in den internen ReadLine Puffer eingelesenen Zeichen werden verworfen.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. Da die Position des Readers in der Zeichenfolge nicht geändert werden kann, können die bereits gelesenen Zeichen nicht wieder hergestellt werden, und der Zugriff darauf ist nur StringReadermöglich, wenn erneut initialisiert wird.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. Um eine solche Situation zu vermeiden, verwenden Read Sie die-Methode, und speichern Sie die Lesezeichen in einem vorab zugeordneten Puffer.To avoid such a situation, use the Read method and store the read characters in a preallocated buffer.

In der folgenden Tabelle sind Beispiele für andere typische oder Verwandte e/a-Aufgaben aufgeführt.The following table lists examples of other typical or related I/O tasks.

AufgabeTo do this... Siehe das Beispiel in diesem Thema:See the example in this topic...
Erstellen einer TextdateiCreate a text file. Gewusst wie: Schreiben von Text in eine DateiHow to: Write Text to a File
Schreiben in eine Textdatei.Write to a text file. Gewusst wie: Schreiben von Text in eine DateiHow to: Write Text to a File
Aus einer Textdatei lesen.Read from a text file. Gewusst wie: Lesen von Text aus einer DateiHow to: Read Text from a File
Anfügen von Text an eine Datei.Append text to a file. Gewusst wie: Öffnen und Anfügen an eine ProtokolldateiHow to: Open and Append to a Log File

File.AppendText

FileInfo.AppendText
Gibt die Größe einer Datei an.Get the size of a file. FileInfo.Length
Die Attribute einer Datei erhalten.Get the attributes of a file. File.GetAttributes
Legen Sie die Attribute einer Datei fest.Set the attributes of a file. File.SetAttributes
Stellen Sie fest, ob eine Datei vorhanden ist.Determine if a file exists. File.Exists
Lesen aus einer Binärdatei.Read from a binary file. Gewusst wie: Lesen und Schreiben einer neu erstellten DatendateiHow to: Read and Write to a Newly Created Data File
Schreiben in eine Binärdatei.Write to a binary file. Gewusst wie: Lesen und Schreiben einer neu erstellten DatendateiHow to: Read and Write to a Newly Created Data File

Gilt für:

Siehe auch