WinFormsアプリケーションでユーザー指定のフォルダにデータを保存する技術資料

2024年9月4日

この資料は、WinFormsアプリケーションにおいて、ユーザーが指定したフォルダにテキストデータを保存・読み込む方法を説明します。また、ユーザーが選択した保存場所を保持するために、プロジェクトの設定にカスタム設定項目を追加する手順についても説明します。

前提条件

Visual Studioがインストールされていること
基本的なC#プログラミングの知識があること
WinFormsプロジェクトが作成済みであること

1. カスタム設定の追加

プロジェクトにカスタム設定を追加し、ユーザーが選択したフォルダパスを保存できるようにします。

Visual Studioでプロジェクトを開く:
- ソリューションエクスプローラーでプロジェクトを右クリックし、「プロパティ」を選択します。
設定 (Settings) タブを開く:
- プロパティウィンドウで、左側のメニューから「設定 (Settings)」を選択します。
新しい設定を追加:
- 設定タブで以下の情報を入力して新しい設定を追加します。
  - 名前: SaveFolderPath
  - 型: String
  - スコープ: User
  - 値: 空白（デフォルト値なし）
設定を保存:
- Ctrl + Sで設定を保存します。

2. フォルダ選択ダイアログを使用したフォルダパスの保存

ユーザーが選択したフォルダにテキストデータを保存するために、以下のメソッドを実装します。

using System;
using System.IO;
using System.Windows.Forms;

public void SelectSaveFolder()
{
    using (FolderBrowserDialog dialog = new FolderBrowserDialog())
    {
        dialog.Description = "データの保存場所を選択してください";
        dialog.ShowNewFolderButton = true;

        if (dialog.ShowDialog() == DialogResult.OK)
        {
            string selectedPath = dialog.SelectedPath;
            SaveTextToFile(selectedPath, "UserData.txt", "このデータはユーザー指定のフォルダに保存されます。");

            // フォルダパスを設定に保存
            SaveFolderPathSetting(selectedPath);
        }
    }
}

3. テキストファイルの保存・読み込みの実装

ユーザーが選択したフォルダにテキストファイルを保存し、そのデータを読み込むためのメソッドを以下に示します。

public void SaveTextToFile(string folderPath, string fileName, string content)
{
    // フォルダが存在しない場合は作成
    if (!Directory.Exists(folderPath))
    {
        Directory.CreateDirectory(folderPath);
    }

    // 指定されたパスにファイルを作成
    string filePath = Path.Combine(folderPath, fileName);
    using (StreamWriter writer = new StreamWriter(filePath))
    {
        writer.Write(content);
    }
}

public string LoadTextFromFile(string folderPath, string fileName)
{
    string filePath = Path.Combine(folderPath, fileName);
    if (File.Exists(filePath))
    {
        using (StreamReader reader = new StreamReader(filePath))
        {
            return reader.ReadToEnd();
        }
    }
    else
    {
        return null;
    }
}

4. 設定の保存と読み込み

ユーザーが選択した保存場所を保持するためのメソッドを以下に実装します。

public void SaveFolderPathSetting(string folderPath)
{
    Properties.Settings.Default.SaveFolderPath = folderPath;
    Properties.Settings.Default.Save();
}

public string LoadFolderPathSetting()
{
    return Properties.Settings.Default.SaveFolderPath;
}

5. 全体の使用例

アプリケーション起動時に保存場所を確認し、データを読み込むコードの例です。

private void MainForm_Load(object sender, EventArgs e)
{
    string saveFolderPath = LoadFolderPathSetting();
    if (!string.IsNullOrEmpty(saveFolderPath))
    {
        // 指定されたフォルダが存在するか確認
        if (Directory.Exists(saveFolderPath))
        {
            string content = LoadTextFromFile(saveFolderPath, "UserData.txt");
            MessageBox.Show(content);
        }
        else
        {
            MessageBox.Show("保存場所が存在しません。");
        }
    }
}

private void btnSaveData_Click(object sender, EventArgs e)
{
    SelectSaveFolder();
}