C# ファイル出力 streamwriter

このサイトはプロモーションを含みます

2024年9月11日

C#でプログラミングをしていると、データをファイルに出力する必要が頻繁に出てきます。ログの記録、設定の保存、データのエクスポートなど、様々な場面でファイル出力は重要な役割を果たします。この記事では、C#でStreamWriterを使用してファイルに出力する方法を、初心者の方にも分かりやすく解説します。

StreamWriterとは

StreamWriterは、C#の System.IO 名前空間に含まれるクラスで、テキストファイルへの書き込みを簡単に行うことができます。文字列データを効率的にファイルに書き込むための様々なメソッドを提供しています。

基本的なファイル出力

まずは、StreamWriterを使用して簡単なテキストファイルを作成する例を見てみましょう。

using System;
using System.IO;

class Program
{
    static void Main()
    {
        string filePath = "example.txt";

        try
        {
            // StreamWriterを使用してファイルを作成し、テキストを書き込む
            using (StreamWriter writer = new StreamWriter(filePath))
            {
                writer.WriteLine("これはC#でStreamWriterを使用して書き込まれた最初の行です。");
                writer.WriteLine("これは2行目です。");
                writer.WriteLine("そして、これが3行目です。");
            }

            Console.WriteLine("ファイルへの書き込みが完了しました。");
        }
        catch (IOException e)
        {
            Console.WriteLine("ファイルの書き込み中にエラーが発生しました: " + e.Message);
        }
    }
}

このコードを実行すると、example.txtというファイルが作成され、3行のテキストが書き込まれます。

既存ファイルへの追記

既存のファイルに新しい内容を追加したい場合は、StreamWriterのコンストラクタに第二引数としてtrueを指定します。

using (StreamWriter writer = new StreamWriter(filePath, true))
{
    writer.WriteLine("この行は既存のファイルに追加されます。");
}

書き込み時のオプション

StreamWriterには、書き込み時のパフォーマンスや動作を制御するためのオプションがあります。

using (StreamWriter writer = new StreamWriter(filePath, false, Encoding.UTF8, 1024))
{
    writer.WriteLine("この行はUTF-8エンコーディングで書き込まれます。");
}

このコードでは、UTF-8エンコーディングを指定し、バッファサイズを1024バイトに設定しています。

大量のデータを効率的に書き込む

大量のデータを書き込む場合は、バッファリングを活用することでパフォーマンスを向上させることができます。

using (StreamWriter writer = new StreamWriter(filePath))
{
    for (int i = 0; i < 1000000; i++)
    {
        writer.WriteLine($"これは{i + 1}行目です。");
        
        // 定期的にバッファをフラッシュする
        if (i % 10000 == 0)
        {
            writer.Flush();
        }
    }
}

このコードでは、100万行のデータを書き込みながら、1万行ごとにバッファをフラッシュしています。