StringReader.ReadLine Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Liest eine Zeichenzeile aus der aktuellen Zeichenfolge und gibt die Daten als Zeichenfolge zurück.
public:
override System::String ^ ReadLine();
public override string ReadLine();
public override string? ReadLine();
override this.ReadLine : unit -> string
Public Overrides Function ReadLine () As String
Gibt zurück
Die nächste Zeile aus der aktuellen Zeichenfolge oder null wenn das Ende der Zeichenfolge erreicht ist.
Ausnahmen
Der aktuelle Reader ist geschlossen.
Es ist nicht genügend Arbeitsspeicher vorhanden, um einen Puffer für die zurückgegebene Zeichenfolge zuzuweisen.
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, 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 Zeile wird als Folge von Zeichen definiert, gefolgt von einem Zeilenvorschub ("\n"), einer Wagenrücklauf ("\r"), einer Wagenrücklauf, die unmittelbar nach einem Zeilenvorschub ("\r\n") oder der End-of-Stream-Markierung folgt. Die zurückgegebene Zeichenfolge enthält nicht den endenden Wagenrücklauf oder Zeilenvorschub. Der zurückgegebene Wert ist null , wenn die End-of-Stream-Markierung erreicht wurde. Das heißt, wenn zwischen dem letzten Lesen der Zeile und der End-of-Stream-Markierung nichts vorhanden ist, gibt die Methode zurück null.
Wenn die Zeichenfolge mit einer Newlinesequenz endet, wird keine zusätzliche leere Zeile zurückgegeben. Beispielsweise erzeugt die Zeichenfolge die gleichen beiden Zeilen ( und ) wie die Zeichenfolge "line1\nline2\n""line1\nline2"."line2""line1"
Wenn die aktuelle Methode eine OutOfMemoryExceptionZeichenfolge auslö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 gelesen wurden, werden verworfen. Da die Position des Lesers in der Zeichenfolge nicht geändert werden kann, sind die bereits gelesenen Zeichen nicht wiederhergestellt und können nur durch erneutes Initialisieren der StringReaderZeichenfolge aufgerufen werden. Um eine solche Situation zu vermeiden, verwenden Sie die Read Methode, und speichern Sie die Lesezeichen in einem vordefinierten Puffer.
In der folgenden Tabelle sind Beispiele für andere typische oder verwandte E/A-Aufgaben aufgeführt.
| Um dies zu tun... | Sehen Sie sich das Beispiel in diesem Thema an... |
|---|---|
| Erstellen Sie eine Textdatei. | Vorgehensweise: Schreiben von Text in eine Datei |
| Schreiben in eine Textdatei. | Vorgehensweise: Schreiben von Text in eine Datei |
| Aus einer Textdatei lesen. | Vorgehensweise: Lesen von Text aus einer Datei |
| Anfügen von Text an eine Datei. |
Vorgehensweise: Öffnen und Anfügen an eine Protokolldatei File.AppendText FileInfo.AppendText |
| Ruft die Größe einer Datei ab. | FileInfo.Length |
| Ruft 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. | Vorgehensweise: Lesen und Schreiben in eine neu erstellte Datendatei |
| Schreiben in eine Binärdatei. | Vorgehensweise: Lesen und Schreiben in eine neu erstellte Datendatei |