StringReader.ReadLine Methode

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Quelle:

StringReader.cs

Liest eine Zeile von Zeichen aus der aktuellen Zeichenkette und gibt die Daten als Zeichenfolge zurück.

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

public override string? ReadLine ();

override this.ReadLine : unit -> string

Public Overrides Function ReadLine () As String

Gibt zurück

String

Die nächste Zeile der aktuellen Zeichenfolge oder null, wenn das Ende der Zeichenfolge erreicht ist.

Ausnahmen

ObjectDisposedException

Der aktuelle Reader ist geschlossen.

OutOfMemoryException

Es ist nicht genügend Speicher vorhanden, um einen Puffer für die zurückgegebene Zeichenfolge zuzuordnen.

Beispiele

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die StringReader-Klasse bereitgestellt wird.

// 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 setzt die TextReader.ReadLine -Methode außer Kraft.

Eine Linie ist definiert als eine Sequenz von Zeichen gefolgt von einem Zeilenvorschub ("\n"), einem Wagenrücklauf ("\r"), einem Wagenrücklauf unmittelbar gefolgt von einem Zeilenvorschub ("\r\n") oder der Markierung zum Ende des Datenstroms. Die zurückgegebene Zeichenfolge enthält weder den beendenden Wagenrücklauf noch den Zeilenvorschub. Der zurückgegebene Wert ist null , wenn der Marker für das Ende des Datenstroms erreicht wurde. Das heißt, wenn zwischen der letzten gelesenen Zeile und dem Marker zum Ende des Datenstroms nichts vorhanden ist, gibt die -Methode zurück null.

Wenn die aktuelle Methode einen OutOfMemoryExceptionauslöst, wird die Position des Lesers in der zugrunde liegenden Zeichenfolge um die Anzahl der Zeichen erweitert, die die Methode lesen konnte, aber die Zeichen, die bereits in den internen ReadLine Puffer eingelesen wurden, werden verworfen. Da die Position des Leselesers in der Zeichenfolge nicht geändert werden kann, sind die bereits gelesenen Zeichen nicht wiederherstellbar und können nur durch erneutes Initialisieren von StringReaderzugegriffen werden. Um eine solche Situation zu vermeiden, verwenden Sie die Read -Methode, und speichern Sie die Lesezeichen in einem vorab zugewiesenen Puffer.

Die folgende Tabelle enthält Beispiele für andere typische oder verwandte E/A-Aufgaben.

Aufgabe	Siehe das Beispiel in diesem Thema:
Erstellen einer Textdatei	How to: Schreiben von Text in eine Datei
Schreiben Sie in eine Textdatei.	How to: Schreiben von Text in eine Datei
Aus einer Textdatei lesen.	How to: Lesen von Text aus einer Datei
Fügen Sie Text an eine Datei an.	How to: Öffnen und Anfügen an eine Protokolldatei File.AppendText FileInfo.AppendText
Rufen Sie die Größe einer Datei ab.	FileInfo.Length
Rufen Sie die Attribute einer Datei ab.	File.GetAttributes
Legen Sie die Attribute einer Datei fest.	File.SetAttributes
Ermitteln Sie, ob eine Datei vorhanden ist.	File.Exists
Aus einer Binärdatei lesen.	How to: Vorgehensweise: Lesen von bzw. Schreiben in eine neu erstellte Datendatei
Schreiben Sie in eine Binärdatei.	How to: Vorgehensweise: Lesen von bzw. Schreiben in eine neu erstellte Datendatei

Weitere Informationen

• Datei- und Stream-E/A
• How to: Lesen von Text aus einer Datei
• How to: Schreiben von Text in eine Datei