StringReader.ReadToEnd Methode

Definition

Liest alle Zeichen von der aktuellen Position bis zum Ende des Streams und gibt diese als einzelne Zeichenfolge zurück.Reads all characters from the current position to the end of the string and returns them as a single string.

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

Gibt zurück

Der Inhalt ab der aktuellen Position bis zum Ende der zugrunde liegenden Zeichenfolge.The content from the current position to the end of the underlying string.

Ausnahmen

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.

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

Beispiele

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die TextReader -Klasse bereitgestellt wird.This code example is part of a larger example provided for the TextReader class.

void ReadText( TextReader^ textReader )
{
   Console::WriteLine( "From {0} - {1}", textReader->GetType()->Name, textReader->ReadToEnd() );
}


static void ReadText(TextReader textReader)
{
    Console.WriteLine("From {0} - {1}", 
        textReader.GetType().Name, textReader.ReadToEnd());
}
Shared Sub ReadText(aTextReader As TextReader)
    Console.WriteLine("From {0} - {1}", _
        aTextReader.GetType().Name, aTextReader.ReadToEnd())
End Sub

Hinweise

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

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 ReadToEnd 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 ReadToEnd 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