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.

I/O エラーが発生します。An I/O error occurs.

次のコード例では、1回の操作でファイルの末尾までを読み取ります。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 kb (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.

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

適用対象

こちらもご覧ください