C#のFileStreamクラスの使い方を徹底解説！ファイル読み書きの基本

C#のFileStreamクラスとは？

FileStreamクラスは、C#でファイルに対して読み込み・書き込みなどの操作を行うためのストリームを提供するクラスです。System.IO名前空間に属しており、バイト単位でファイルにアクセスできるため、テキストファイルだけでなくバイナリデータの処理にも活用できます。

FileStreamオブジェクトの作成方法

FileStreamクラスを使用するには、まずインスタンスを作成します。基本的な作成方法は以下のとおりです。

FileStream fstream = new FileStream("d:\\new.txt", FileMode.OpenOrCreate);

この例では、FileMode.OpenOrCreate を指定しています。これにより、指定したファイルがすでに存在する場合はそのファイルが開かれ、存在しない場合は新しく作成されます。

主なFileModeの種類

• OpenOrCreate： ファイルがあれば開き、なければ新規作成する
• CreateNew： 新しいファイルを作成する（既に存在すると例外が発生）
• Open： 既存のファイルを開く（存在しないと例外が発生）
• Append： ファイル末尾に追記するモードで開く

FileStreamクラスの使用例

以下は、C#でFileStreamクラスを使ってファイルにデータを書き込むサンプルコードです。

using System;
using System.IO;

public class Demo {
    public static void Main(string[] args) {
        FileStream fstream = new FileStream("d:\\new.txt", FileMode.OpenOrCreate);

        // ファイルに1バイト書き込む
        fstream.WriteByte(90);

        // ファイルを閉じる
        fstream.Close();
    }
}

コードの解説

このプログラムでは、まず「d:\new.txt」へのFileStreamを作成しています。次に、WriteByteメソッドを使って値90（ASCIIコードでは文字「Z」）を1バイト分書き込んでいます。最後にCloseメソッドを呼び出してファイルを閉じ、リソースを解放しています。

使用時の注意点

FileStreamは使用後に必ずCloseメソッド（またはDisposeメソッド）を呼び出してリソースを解放しましょう。usingステートメントを利用すれば、処理終了時に自動的にクローズされるため、より安全なコードになります。