【C#】ファイルを読み込む方法を紹介（StreamReader）

2024年1月28日

当ページのリンクには広告が含まれています。

URLをコピーしました！

C# で文字列を記入してファイル内のテキストを取得する方法を紹介します。

ファイルのデータを読み込むにはどうしたらいい！？

初期設定ファイルや設定ファイル等、ファイルに保存されているデータを読み込んでから処理することがあります。ファイルの読み込み方法を知っているとアプリケーションの開発の幅が広がります。

C# では読み込み以外にもファイルの書き込みも可能です。詳しくはこちらのサイトで紹介していますので、参考にしてみてください。

あわせて読みたい

【C#】ファイルに書き込む方法を紹介（StreamWriter） C# で文字列を記入してファイルを出力する方法を紹介します。ファイルにデータを保存するにはどうしたらいい！？アプリケーションを開発していると、「ファイルにデー…

この記事ではファイルのテキストを読み込む方法を２種類（ReadToEnd・ReadLine）紹介していますので、ぜひ最後まで読んでみてください。

あわせて読みたい

【C#】おすすめする入門書（参考書）５選を紹介！ C# とはマイクロソフトが開発したプログラミング言語であり、Windows向けのアプリケーション開発から、Android向けのアプリケーション開発、Web向けのアプリケーション…

オススメの参考書

C#の使い方が丁寧に解説しており、「基礎からしっかりと学びたい」という初心者の方にオススメの一冊です。サンプルコードも記載してあり、各章の最後に復習問題があるので理解度を確認しながら読み進めることができます。新しい C# のバージョンにも対応している書籍です。

基礎からしっかり学ぶC#の教科書第3版 C# 10対応

Amazon

＼楽天ポイント4倍セール！／

楽天市場

Yahooショッピング

ポチップ

ファイルを読み込むには？

C# でファイルの読み込みをする場合は、「StreamReader クラス」を使うのが一般的です。ファイルの読み込み専用のクラスで、ファイルのテキストを読み込む ReadToEnd メソッドや ReadLine メソッドが用意されています。

メソッド名	説明
ReadToEnd	ストリームの文字を全て（ストリームの現在位置から末尾まで）読み込みます。
ReadToEndAsync	非同期でストリームの文字を全て読み込みます。
ReadLine	ストリームから1行分の文字列を読み込みます。
ReadLineAsync	非同期でストリームから1行分の文字列を読み込みます。

ストリームは「データの流れ」を意味し、ストリームでファイル内のテキストが読み込まれる。
ストリームには「現在の位置」を基準にしてデータの読み書きをする。
ストリームを読み書きすると読み書きした分だけ自動的に位置が移動する。

StreamReader はファイル名を指定します。このファイル名の拡張子は自由に設定が可能ですので、テキストファイル（.txt）やCSVファイル（.csv）、ログファイル（.log）からテキストを読み込めるという特徴があります。

指定したファイル名がない場合は例外が発生し、「ファイル ‘ファイルパス’ が見つかりませんでした。」という例外のメッセージが取得できます。

ファイルの読み込む方法

ここからはファイルからテキストを読み込む方法を紹介します。

まずは StreamReader を利用できるように、クラスファイルのヘッダー部分に名前空間「System.IO」を設定しましょう。

using System.IO;

ファイルからテキストを読み込むには、３つの処理を順番に行うのが基本です。

StreamReader クラスのコンストラクタの引数にファイルパス、エンコードの指定を行います。

StreamReader(ファイルパス, エンコード)

第１引数は string 型で、ファイル名もしくはファイルの絶対パスを指定します。

第２引数は必ずしも必要ではありません。文字のエンコードを指定しない場合は、デフォルト値（UTF-8）を使用してファイルのテキストを読み込みます。

エンコードにはいくつかの種類があり、C# でエンコードを指定する例を挙げておきます。

エンコードの種類	エンコーの指定
日本語 Shift-JIS	Encoding.GetEncoding(“shift_jis”)
日本語 EUC	Encoding.GetEncoding(“euc-jp”)
日本語 JIS	Encoding.GetEncoding(“iso-2022-jp”)
Unicode	Encoding.Unicode
UTF8	Encoding.UTF-8
UTF-32	Encoding.UTF32

読み込むファイルを準備をしておきましょう。ここでは「sample.txt」という名前で以下のテキストを入力して、文字コードの種類を「ANSI」にします。

アプリケーションの実行ファイルがあるディレクトリ（bin\Debug）にファイルを保管しておきます。

ReadToEnd メソッド

StreamReader クラスの ReadToEnd メソッドは、ファイルの全てのテキストを１つの文字列として読み込む方法です。

private void ReadToEndFile()
{
    //ファイル名
    var fileName = "sample.txt";

    //読み込むテキストを保存する変数
    var text = "";

    try
    {
        //ファイルをオープンする
        using (StreamReader sr = new StreamReader(fileName, Encoding.GetEncoding("Shift_JIS")))
        {
            text = sr.ReadToEnd();
        }
    }
    catch (Exception ex)
    {
        MessageBox.Show(ex.Message);
    }

    Debug.WriteLine(text);
}

上記のソースコードを実行すると次の結果になります。ReadToEnd メソッドは改行を含めて１つの文字列として読み込むことができます。

月曜日
火曜日
水曜日
木曜日
金曜日

StreamReader クラスを使用した後は Close メソッドでストリームを閉じます。この時、Close メソッドを呼び出すことを忘れてしまうとリソースが解放されません。

StreamReader でファイルをオープンしたら、Close メソッドを呼び出してストリームを閉じます。
Close メソッドを呼び出すことで、関連付けられた全てのリソースが解放されます。

using を使っておけば、Close メソッドを実装しなくても自動で解放処理を行うので、Close メソッドの記述漏れを防ぐことができます。

ReadToEndAsync メソッド

非同期でファイルの全てのテキストを１つの文字列として読み込む方法です。

ファイルにある大量のテキストを取得すると発生するデッドロックを防止することができます。

private async Task ReadToEndFileAsync()
{
    //ファイル名
    var fileName = "sample.txt";

    //読み込むテキストを保存する変数
    var text = "";

    try
    {
        //ファイルをオープンする
        using (StreamReader sr = new StreamReader(fileName, Encoding.GetEncoding("Shift_JIS")))
        {
            text = await sr.ReadToEndAsync();
        }
    }
    catch (Exception ex)
    {
        MessageBox.Show(ex.Message);
    }

    Debug.WriteLine(text);
}

ReadToEnd メソッドを ReadToEndAsync メソッドに変更し、非同期のお約束事である「async / await」を付けます。

上記のソースコードを実行すると次の結果になります。ReadToEnd メソッドと同じで改行を含めて１つの文字列として読み込むことができます。

月曜日
火曜日
水曜日
木曜日
金曜日

ReadLine メソッド

StreamReader クラスの ReadLine メソッドで、指定したファイルのテキストを１行ずつ文字列として読み込む方法です。

ReadLine で１行ずつ文字列を読み込む場合は、StreamReader クラスに用意されている Peek メソッドを使って、読み取り対象のファイルに読み取りする行が存在するか確認しながら処理をします。Peek メソッドは読み取りする行がない場合は -1 を返します。

Peek メソッドの戻り値が０以上であるなら、読み取りする行が存在するということなので、ReadLine メソッドで読み取りする事ができます。

private void ReadLineFile()
{
    //ファイル名
    var fileName = "sample.txt";
    //var fileName = @"C:\sample.txt";  絶対パスでも良い

    //読み込むテキストを保存する変数
    var texts = new List<string>();

    try
    {
        //ファイルをオープンする
        using (StreamReader sr = new StreamReader(fileName, Encoding.GetEncoding("Shift_JIS")))
        {
            while (0 <= sr.Peek())
            {
                texts.Add(sr.ReadLine());
            }
        }
    }
    catch (Exception ex)
    {
        MessageBox.Show(ex.Message);
    }

    foreach (var text in texts) { Debug.WriteLine(text); }
}

上記のソースコードを実行すると次の結果になります。ReadLine メソッドは１行毎に読み込むことができます。while文で１行目から最後の行まで繰り返して読み込みをしています。

月曜日
火曜日
水曜日
木曜日
金曜日

ReadLineAsync メソッド

非同期で指定したファイルのテキストを１行ずつ文字列として読み込む方法です。

ファイルにある大量のテキストを取得すると発生するデッドロックを防止することができます。

private async Task ReadLineFileAsync()
{
    //ファイル名
    var fileName = "sample.txt";
    //var fileName = @"C:\sample.txt";  絶対パスでも良い

    //読み込むテキストを保存する変数
    var texts = new List<string>();

    try
    {
        //ファイルをオープンする
        using (StreamReader sr = new StreamReader(fileName, Encoding.GetEncoding("Shift_JIS")))
        {
            while (0 <= sr.Peek())
            {
                texts.Add(await sr.ReadLineAsync());
            }
        }
    }
    catch (Exception ex)
    {
        MessageBox.Show(ex.Message);
    }

    foreach (var text in texts) { Debug.WriteLine(text); }
}

ReadLine メソッドを ReadLineAsync メソッドに変更し、非同期のお約束事である「async / await」を付けます。

上記のソースコードを実行すると次の結果になります。ReadLine メソッドと同じで１行毎に読み込むことができます。

月曜日
火曜日
水曜日
木曜日
金曜日