StreamReader.ReadToEnd Methode

Definition

Liest alle Zeichen von der aktuellen Position bis zum Ende des Streams.Reads all characters from the current position to the end of the stream.

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

Gibt zurück

String

Der Rest des Streams als Zeichenfolge, von der aktuellen Position bis zum Ende.The rest of the stream as a string, from the current position to the end. Wenn die aktuelle Position am Ende des Streams ist, wird eine leere Zeichenfolge ("") zurückgegeben.If the current position is at the end of the stream, returns an empty 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.

Ein E/A-Fehler tritt auf.An I/O error occurs.

Beispiele

Im folgenden Codebeispiel wird der gesamte Vorgang bis zum Ende einer Datei in einem Vorgang durchlaufen.The following code example reads all the way to the end of a file in one operation.

using namespace System;
using namespace System::IO;
int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   try
   {
      if ( File::Exists( path ) )
      {
         File::Delete( path );
      }
      StreamWriter^ sw = gcnew StreamWriter( path );
      try
      {
         sw->WriteLine( "This" );
         sw->WriteLine( "is some text" );
         sw->WriteLine( "to test" );
         sw->WriteLine( "Reading" );
      }
      finally
      {
         delete sw;
      }

      StreamReader^ sr = gcnew StreamReader( path );
      try
      {
         //This allows you to do one Read operation.
         Console::WriteLine( sr->ReadToEnd() );
      }
      finally
      {
         delete sr;
      }
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "The process failed: {0}", e );
   }
}
using System;
using System.IO;

class Test
{
    
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        try
        {
            if (File.Exists(path))
            {
                File.Delete(path);
            }

            using (StreamWriter sw = new StreamWriter(path))
            {
                sw.WriteLine("This");
                sw.WriteLine("is some text");
                sw.WriteLine("to test");
                sw.WriteLine("Reading");
            }

            using (StreamReader sr = new StreamReader(path))
            {
                //This allows you to do one Read operation.
                Console.WriteLine(sr.ReadToEnd());
            }
        }
        catch (Exception e)
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}
Imports System.IO
Imports System.Text

Public Class Test

    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"

        Try
            If File.Exists(path) Then
                File.Delete(path)
            End If

            Dim sw As StreamWriter = New StreamWriter(path)
            sw.WriteLine("This")
            sw.WriteLine("is some text")
            sw.WriteLine("to test")
            sw.WriteLine("Reading")
            sw.Close()

            Dim sr As StreamReader = New StreamReader(path)

            'This allows you to do one Read operation.
            Console.WriteLine(sr.ReadToEnd())
            sr.Close()
        Catch e As Exception
            Console.WriteLine("The process failed: {0}", e.ToString())
        End Try
    End Sub
End Class

Hinweise

Diese Methode überschreibt TextReader.ReadToEnd.This method overrides TextReader.ReadToEnd.

ReadToEnd funktioniert am besten, wenn Sie alle Eingaben von der aktuellen Position bis zum Ende des Streams lesen müssen.ReadToEnd works best when you need to read all the input from the current position to the end of the stream. Wenn mehr Kontrolle über die Anzahl der aus dem Stream gelesenen Zeichen benötigt wird, verwenden Sie die- Read(Char[], Int32, Int32) Methoden Überladung, die in der Regel eine bessere Leistung zur Folge hat.If more control is needed over how many characters are read from the stream, use the Read(Char[], Int32, Int32) method overload, which generally results in better performance.

ReadToEnd geht davon aus, dass der Stream weiß, wann er ein Ende erreicht hat.ReadToEnd assumes that the stream knows when it has reached an end. Bei interaktiven Protokollen, bei denen der Serverdaten nur dann sendet, wenn Sie ihn anfordern, und die Verbindung nicht schließt, ReadToEnd kann möglicherweise unbegrenzt blockieren, da er kein Ende erreicht und daher vermieden werden sollte.For interactive protocols in which the server sends data only when you ask for it and does not close the connection, ReadToEnd might block indefinitely because it does not reach an end, and should be avoided.

Beachten Sie, dass es bei der Verwendung der- Read Methode effizienter ist, einen Puffer zu verwenden, der dieselbe Größe hat wie der interne Puffer des Streams.Note that when using the Read method, it is more efficient to use a buffer that is the same size as the internal buffer of the stream. Wenn die Größe des Puffers nicht angegeben wurde, als der Stream erstellt wurde, beträgt die Standardgröße 4 Kilobyte (4096 Bytes).If the size of the buffer was unspecified when the stream was constructed, its default size is 4 kilobytes (4096 bytes).

Wenn die aktuelle Methode einen auslöst OutOfMemoryException , wird die Position des Readers im zugrunde liegenden Stream Objekt um die Anzahl der Zeichen erweitert, die von der Methode gelesen werden konnten, aber die bereits in den internen Puffer gelesenen Zeichen ReadLine werden verworfen.If the current method throws an OutOfMemoryException, the reader's position in the underlying Stream object 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. Wenn Sie die Position des zugrunde liegenden Streams nach dem Lesen von Daten in den Puffer ändern, entspricht die Position des zugrunde liegenden Streams möglicherweise nicht der Position des internen Puffers.If you manipulate the position of the underlying stream after reading data into the buffer, the position of the underlying stream might not match the position of the internal buffer. Um den internen Puffer zurückzusetzen, müssen Sie die- DiscardBufferedData Methode aufrufen. diese Methode verlangsamt jedoch die Leistung und sollte nur aufgerufen werden, wenn dies unbedingt erforderlich ist.To reset the internal buffer, call the DiscardBufferedData method; however, this method slows performance and should be called only when absolutely necessary.

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Gilt für:

Weitere Informationen