StreamReader クラス

定義

public ref class StreamReader : System::IO::TextReader

public class StreamReader : System.IO.TextReader

[System.Serializable]
public class StreamReader : System.IO.TextReader

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class StreamReader : System.IO.TextReader

type StreamReader = class
    inherit TextReader

[<System.Serializable>]
type StreamReader = class
    inherit TextReader

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StreamReader = class
    inherit TextReader

Public Class StreamReader
Inherits TextReader

継承

Object

TextReader

StreamReader

継承

Object

MarshalByRefObject

TextReader

StreamReader

属性

SerializableAttribute ComVisibleAttribute

例

次の例では、 の StreamReader インスタンスを使用してファイルからテキストを読み取ります。 この例で使用するコンストラクターは、Windows ストア アプリでの使用はサポートされていません。

using namespace System;
using namespace System::IO;
int main()
{
   try
   {
      // Create an instance of StreamReader to read from a file.
      StreamReader^ sr = gcnew StreamReader( "TestFile.txt" );
      try
      {
         String^ line;
         
         // Read and display lines from the file until the end of 
         // the file is reached.
         while ( line = sr->ReadLine() )
         {
            Console::WriteLine( line );
         }
      }
      finally
      {
         if ( sr )
            delete (IDisposable^)sr;
      }
   }
   catch ( Exception^ e ) 
   {
      // Let the user know what went wrong.
      Console::WriteLine( "The file could not be read:" );
      Console::WriteLine( e->Message );
   }
}

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        try
        {
            // Create an instance of StreamReader to read from a file.
            // The using statement also closes the StreamReader.
            using (StreamReader sr = new StreamReader("TestFile.txt"))
            {
                string line;
                // Read and display lines from the file until the end of
                // the file is reached.
                while ((line = sr.ReadLine()) != null)
                {
                    Console.WriteLine(line);
                }
            }
        }
        catch (Exception e)
        {
            // Let the user know what went wrong.
            Console.WriteLine("The file could not be read:");
            Console.WriteLine(e.Message);
        }
    }
}

Imports System.IO

Class Test
    Public Shared Sub Main()
        Try
            ' Create an instance of StreamReader to read from a file.
            Dim sr As StreamReader = New StreamReader("TestFile.txt")
            Dim line As String
            ' Read and display the lines from the file until the end 
            ' of the file is reached.
            Do
                line = sr.ReadLine()
                Console.WriteLine(Line)
            Loop Until line Is Nothing
            sr.Close()
        Catch E As Exception
            ' Let the user know what went wrong.
            Console.WriteLine("The file could not be read:")
            Console.WriteLine(E.Message)
        End Try
    End Sub
End Class

次の例では、 オブジェクトを StreamReader インスタンス化し、そのメソッドを ReadAsync 呼び出してファイルを非同期的に読み取ります。

using System;
using System.IO;
using System.Threading.Tasks;

class Example
{
    static async Task Main()
    {
        await ReadAndDisplayFilesAsync();
    }

    static async Task ReadAndDisplayFilesAsync()
    {
        String filename = "TestFile1.txt";
        Char[] buffer;

        using (var sr = new StreamReader(filename)) {
            buffer = new Char[(int)sr.BaseStream.Length];
            await sr.ReadAsync(buffer, 0, (int)sr.BaseStream.Length);
        }

        Console.WriteLine(new String(buffer));
    }
}
// The example displays the following output:
//       This is the first line of text in a relatively short file.
//       This is the second line.
//       This is the third line.
//       This is the fourth and final line.

Imports System.IO
Imports System.Threading.Tasks

Module Example
    Public Sub Main()
        ReadAndDisplayFilesAsync()
    End Sub

    Private Async Sub ReadAndDisplayFilesAsync()
        Dim filename As String = "TestFile1.txt"
        Dim buffer() As Char
        
        Using sr As New StreamReader(filename)
            ReDim buffer(CInt(sr.BaseStream.Length))
            Await sr.ReadAsync(buffer, 0, CInt(sr.BaseStream.Length))
        End Using

        Console.WriteLine(New String(buffer))
    End Sub
End Module
' The example displays the following output:
'       This is the first line of text in a relatively short file.
'       This is the second line.
'       This is the third line.
'       This is the fourth and final line.

注釈

StreamReader は特定のエンコードでの文字入力用に設計されています。一方 Stream 、 クラスはバイト入力と出力用に設計されています。 標準のテキスト ファイルから情報行を読み取る場合に使用 StreamReader します。

StreamReader は、現在のシステムの ANSI コード ページに既定値を設定するのではなく、特に指定がない限り、UTF-8 エンコードに既定値を設定します。 UTF-8 は Unicode 文字を正しく処理し、オペレーティング システムのローカライズされたバージョンで一貫した結果を提供します。 プロパティを使用してCurrentEncoding現在の文字エンコードを取得した場合、エンコード自動検出はメソッドの最初の呼び出しReadまで行われないため、最初Readのメソッドの後まで値は信頼できません。

既定では、 StreamReader はスレッド セーフではありません。 スレッド セーフ ラッパーについては、 を参照してください TextReader.Synchronized 。

メソッドと Write(Char[], Int32, Int32) メソッドはRead(Char[], Int32, Int32)、 パラメーターでcount指定された文字数の読み取りと書き込みをオーバーロードします。 これらは、 パラメーターでcount指定されたBufferedStream.Readバイト数の読み取りと書き込みを行う と BufferedStream.Writeから区別されます。 バイト配列要素の BufferedStream 整数を読み書きする場合にのみ、 メソッドを使用します。

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。

コンストラクター

フィールド

プロパティ

メソッド

明示的なインターフェイスの実装

適用対象

こちらもご覧ください

• Encoding
• Stream
• StreamWriter
• ファイルおよびストリーム入出力
• 方法: ファイルからのテキストの読み取り
• 方法: テキストのファイルへの書き込み
• 方法: 新しく作成されたデータ ファイルに対して読み書きする