TextReader.ReadToEnd-Methode

Artikel
08/20/2007

Liest alle Zeichen von der aktuellen Position bis zum Ende von TextReader und gibt diese als einzelne Zeichenfolge zurück.

Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Overridable Function ReadToEnd As String
'Usage
Dim instance As TextReader
Dim returnValue As String

returnValue = instance.ReadToEnd

public virtual string ReadToEnd ()

public:
virtual String^ ReadToEnd ()

public String ReadToEnd ()

public function ReadToEnd () : String

Rückgabewert

Eine Zeichenfolge mit allen Zeichen von der aktuellen Position bis zum Ende von TextReader.

Ausnahmen

Ausnahmetyp	Bedingung
IOException	Ein E/A-Fehler tritt auf.
ObjectDisposedException	Der TextReader ist geschlossen.
OutOfMemoryException	Es ist nicht genügend Speicherplatz vorhanden, um einen Puffer für die zurückgegebene Zeichenfolge zu reservieren.
ArgumentOutOfRangeException	Die Anzahl der Zeichen in der nächsten Zeile ist größer als MaxValue.

Hinweise

Wenn die aktuelle Methode eine OutOfMemoryException auslöst, wird die Position des Readers im zugrunde liegenden Stream um die Anzahl von Zeichen weitergerückt, die die Methode lesen konnte. Die bereits in den internen ReadToEnd-Puffer gelesenen Zeichen werden jedoch verworfen. Da die Position des Readers im Stream nicht geändert werden kann, können die bereits gelesenen Zeichen nicht wiederhergestellt werden. Auf sie kann nur nach erneuter Initialisierung des TextReader zugegriffen werden. Wenn die Ausgangsposition im Stream unbekannt ist oder der Stream keine Suche unterstützt, muss der zugrunde liegende Stream ebenfalls neu initialisiert werden.

Um diese Situation zu vermeiden und stabilen Code zu erstellen, sollten Sie die Read-Methode verwenden und die gelesenen Zeichen in einem vorher reservierten Puffer speichern.

Beispiel

Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die TextReader-Klasse.

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

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

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().get_Name(),textReader.ReadToEnd());
} //ReadText

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

TextReader-Klasse
TextReader-Member
System.IO-Namespace

Weitere Ressourcen

Datei- und Stream-E/A
Gewusst wie: Lesen aus einer Textdatei
Gewusst wie: Schreiben von Text in eine Datei

Freigeben über