StreamReader.ReadToEnd StreamReader.ReadToEnd StreamReader.ReadToEnd StreamReader.ReadToEnd Method

Определение

Считывает все символы, начиная с текущей позиции до конца потока.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

Возвраты

Остальная часть потока в виде строки (от текущего положения до конца).The rest of the stream as a string, from the current position to the end. Если текущее положение находится в конце потока, возвращается пустая строка ("").If the current position is at the end of the stream, returns an empty string ("").

Исключения

Не хватает памяти для выделения буфера под возвращаемую строку.There is insufficient memory to allocate a buffer for the returned string.

Ошибка ввода-вывода.An I/O error occurs.

Примеры

В следующем примере кода считывает вплоть до конца файла в одной операции.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
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

Комментарии

Этот метод переопределяет метод TextReader.ReadToEnd.This method overrides TextReader.ReadToEnd.

ReadToEnd лучше всего работает, когда необходимо считать все входные данные из текущей позиции до конца потока.ReadToEnd works best when you need to read all the input from the current position to the end of the stream. Если требуется больший контроль над количество символов, считанных из потока, используйте Read(Char[], Int32, Int32) перегрузку метода, который обычно обеспечивает лучшую производительность.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 предполагается, что знает, когда был достигнут конец потока.ReadToEnd assumes that the stream knows when it has reached an end. Для интерактивных протоколов, в которых сервер отправляет данные только в том случае, если запроса и не закрывает соединение ReadToEnd может выполняться бесконечно, так как он не достигает конца и следует избегать.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.

Обратите внимание, что при использовании Read метода, это более эффективно использовать буфер такого же размера, как внутренний буфер потока.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. Если размер буфера не был определен при создании потока, его размер по умолчанию — 4 КБ (4096 байт).If the size of the buffer was unspecified when the stream was constructed, its default size is 4 kilobytes (4096 bytes).

Если текущий метод вызывает OutOfMemoryException, позиция средства чтения в базовом Stream объекта увеличивается на число знаков, которое может читать метод, но знаки, уже считанные во внутренний ReadLine буфера, отбрасываются. .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. Если положение базового потока управления после считывания данных в буфер, положение базового потока, может не соответствовать позицию внутреннего буфера.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. Чтобы сбросить внутреннем буфере, вызовите DiscardBufferedData метода; тем не менее, этот метод замедляет производительность и должен вызываться только в том случае, если это абсолютно необходимо.To reset the internal buffer, call the DiscardBufferedData method; however, this method slows performance and should be called only when absolutely necessary.

Список задач ввода-вывода, см. в разделе распространенные задачи ввода-вывода.For a list of common I/O tasks, see Common I/O Tasks.

Применяется к

Дополнительно