C#でテキストファイルを読み書きする方法【StreamReader・StreamWriterの使い方】

C#でテキストファイルを扱う際には、StreamReaderクラスとStreamWriterクラスを使用します。StreamReaderはテキストファイルからのデータ読み取り、StreamWriterはテキストファイルへのデータ書き込みをそれぞれ担当します。どちらもSystem.IO名前空間に属しており、usingディレクティブを使えば、処理終了後に自動的にリソースが解放されるため安全です。

テキストファイルを読み込む

まずは、StreamReaderを使ってテキストファイルの内容を1行ずつ読み込み、コンソールに表示するサンプルコードを見てみましょう。

using System;
using System.IO;

namespace FileApplication {
    class Program {
        static void Main(string[] args) {
            try {
                // ファイルから読み込むためのStreamReaderのインスタンスを作成。
                // usingステートメントにより、StreamReaderも自動的にクローズされる。
                using (StreamReader sr = new StreamReader("d:/new.txt")) {
                    string line;

                    // ファイルの末尾に到達するまで、
                    // 1行ずつ読み込んで表示する。
                    while ((line = sr.ReadLine()) != null) {
                        Console.WriteLine(line);
                    }
                }
            } catch (Exception e) {
                Console.WriteLine("ファイルを読み込めませんでした：");
                Console.WriteLine(e.Message);
            }
            Console.ReadKey();
        }
    }
}

このコードのポイントは以下の通りです。

• try-catchブロックで例外処理を行い、ファイルが存在しない場合などにも適切に対応できます。
• ReadLine()メソッドは1行ずつ文字列を読み込み、ファイルの末尾ではnullを返すため、whileループと組み合わせるのが定番のパターンです。
• usingステートメントを使うことで、スコープを抜けた時点でStreamReaderが自動的に閉じられ、リソースリークを防げます。

テキストファイルに書き込む

次に、StreamWriterを使って配列のデータをテキストファイルに書き込み、その後同じファイルを読み込んで結果を確認する例を紹介します。

サンプルコード

using System;
using System.IO;

namespace FileApplication {
    class Program {
        static void Main(string[] args) {
            string[] names = new string[] {"Jack", "Tom"};

            // StreamWriterでファイルに名前を1行ずつ書き込む。
            using (StreamWriter sw = new StreamWriter("students.txt")) {

                foreach (string s in names) {
                    sw.WriteLine(s);
                }
            }

            // 書き込んだファイルの内容を1行ずつ読み込んで表示する。
            string line = "";
            using (StreamReader sr = new StreamReader("students.txt")) {
                while ((line = sr.ReadLine()) != null) {
                    Console.WriteLine(line);
                }
            }
            Console.ReadKey();
        }
    }
}

実行結果

Jack
Tom

補足ポイント

• WriteLine()メソッドは文字列を書き込んだ後に行末の改行を自動的に追加します。改行が不要な場合はWrite()メソッドを使用してください。
• StreamWriterはデフォルトで既存ファイルを上書きします。追記モードで開きたい場合は、第2引数にtrueを指定してnew StreamWriter("students.txt", true)のように記述します。
• 日本語などのマルチバイト文字を扱う場合は、new StreamReader(path, Encoding.UTF8)のようにエンコーディングを明示的に指定すると、文字化けを防げます。

このようにStreamReaderとStreamWriterを組み合わせれば、C#でのテキストファイルの入出力をシンプルかつ安全に実装できます。ぜひ実際のプロジェクトでも活用してみてください。