WinFormsでのデータファイル配置と読み込み― @”….\data.txt” を卒業しよう

以下は「発展（次の一歩）」をすべて盛り込んだ最小〜実用レベルの WinForms サンプルです。

• OpenFileDialog でデータを選択 → AppData 側にコピーして使用
• 保存（上書き）で AppData 側へ CSV を書き戻し
• FileSystemWatcher で外部更新を検知して自動再読込
• CSV を“簡易パース版”でまず動かし、厳密 CSV は CsvHelper 版に差し替え可能にしてあります

想定 UI

• ListBox nameList（人名一覧）
• TextBox phoneNumber（電話番号表示・ReadOnly 推奨）
• Button btnOpen（CSVを選択）
• Button btnSave（保存）イベントはコード側で配線しているため、デザイナでのイベント設定は不要です。

Form1.cs（完成サンプル）

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Text;
using System.Windows.Forms;

namespace PhoneBook
{
    public partial class Form1 : Form
    {
        private readonly Dictionary<string, string> phoneBook = new Dictionary<string, string>();
        private readonly string appDataDir;
        private readonly string userDataPath;  // 実運用で参照・保存するCSV（AppData側）
        private FileSystemWatcher watcher;
        private DateTime _lastWriteByUsUtc = DateTime.MinValue;   // 保存直後の自己イベントを無視するため

        public Form1()
        {
            InitializeComponent();

            // UI 初期設定（安全側）
            this.phoneNumber.ReadOnly = true;
            this.nameList.SelectionMode = SelectionMode.One;

            // イベント配線（デザイナ設定不要）
            this.Load += Form1_Load;
            this.FormClosed += Form1_FormClosed;
            this.nameList.SelectedIndexChanged += NameSelected;
            this.btnOpen.Click += BtnOpen_Click;
            this.btnSave.Click += BtnSave_Click;

            // AppData 側の保存場所を決定
            appDataDir = Path.Combine(
                Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData),
                "PhoneBook");
            Directory.CreateDirectory(appDataDir);
            userDataPath = Path.Combine(appDataDir, "data.csv");
        }

        //=== 1) 起動時：AppData 側のCSVを用意 → 読み込み → 監視開始 =====================
        private void Form1_Load(object sender, EventArgs e)
        {
            EnsureUserDataExists();
            LoadFromCsv(userDataPath);
            RebuildNameList();
            StartWatch(userDataPath);
        }

        // 初回：実行フォルダの data.csv を AppData にコピー。なければ空ファイルを作る
        private void EnsureUserDataExists()
        {
            if (File.Exists(userDataPath)) return;

            var baseCsv = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "data.csv");
            if (File.Exists(baseCsv))
            {
                File.Copy(baseCsv, userDataPath, overwrite: false);
            }
            else
            {
                File.WriteAllText(userDataPath, "", new UTF8Encoding(encoderShouldEmitUTF8Identifier: true));
            }
        }

        //=== 2) OpenFileDialog：任意のCSVを選び、AppData 側に取り込む =====================
        private void BtnOpen_Click(object sender, EventArgs e)
        {
            using (var ofd = new OpenFileDialog()
            {
                Title = "CSVファイルを選択",
                Filter = "CSVファイル (*.csv;*.txt)|*.csv;*.txt|すべてのファイル (*.*)|*.*",
                CheckFileExists = true,
                Multiselect = false
            })
            {
                if (ofd.ShowDialog(this) != DialogResult.OK) return;

                try
                {
                    // 選択ファイルを AppData 側へコピー（上書き確認）
                    File.Copy(ofd.FileName, userDataPath, overwrite: true);

                    // 自己変更を無視するためにタイムスタンプ
                    _lastWriteByUsUtc = DateTime.UtcNow;

                    // 即時リロード
                    LoadFromCsv(userDataPath);
                    RebuildNameList();
                    MessageBox.Show("データを読み込みました。", "完了",
                        MessageBoxButtons.OK, MessageBoxIcon.Information);
                }
                catch (Exception ex)
                {
                    MessageBox.Show("読み込みに失敗しました。\n" + ex.Message, "エラー",
                        MessageBoxButtons.OK, MessageBoxIcon.Error);
                }
            }
        }

        //=== 3) 保存（上書き）：AppData 側にCSVで書き戻す ================================
        private void BtnSave_Click(object sender, EventArgs e)
        {
            try
            {
                SaveToCsv(userDataPath);
                _lastWriteByUsUtc = DateTime.UtcNow;
                MessageBox.Show("保存しました。", "完了",
                    MessageBoxButtons.OK, MessageBoxIcon.Information);
            }
            catch (Exception ex)
            {
                MessageBox.Show("保存に失敗しました。\n" + ex.Message, "エラー",
                    MessageBoxButtons.OK, MessageBoxIcon.Error);
            }
        }

        //=== 4) FileSystemWatcher：外部更新を自動反映（自己更新はスキップ） =============
        private void StartWatch(string path)
        {
            StopWatch(); // 再設定に備えて一旦停止
            watcher = new FileSystemWatcher()
            {
                Path = Path.GetDirectoryName(path),
                Filter = Path.GetFileName(path),
                NotifyFilter = NotifyFilters.LastWrite | NotifyFilters.Size | NotifyFilters.FileName
            };
            watcher.Changed += Watcher_ChangedOrCreatedOrRenamed;
            watcher.Created += Watcher_ChangedOrCreatedOrRenamed;
            watcher.Renamed += Watcher_ChangedOrCreatedOrRenamed;
            watcher.EnableRaisingEvents = true;
        }

        private void StopWatch()
        {
            if (watcher != null)
            {
                watcher.EnableRaisingEvents = false;
                watcher.Changed -= Watcher_ChangedOrCreatedOrRenamed;
                watcher.Created -= Watcher_ChangedOrCreatedOrRenamed;
                watcher.Renamed -= Watcher_ChangedOrCreatedOrRenamed;
                watcher.Dispose();
                watcher = null;
            }
        }

        // 変更通知の嵐を避けるため、自己保存から1秒以内のイベントは無視し、UIスレッドでデバウンス
        private DateTime _lastReloadRequestUtc = DateTime.MinValue;
        private void Watcher_ChangedOrCreatedOrRenamed(object sender, FileSystemEventArgs e)
        {
            var now = DateTime.UtcNow;

            // 自分が保存した直後のイベントはスキップ
            if ((now - _lastWriteByUsUtc) < TimeSpan.FromSeconds(1))
                return;

            // 過剰トリガーを間引き
            if ((now - _lastReloadRequestUtc) < TimeSpan.FromMilliseconds(300))
                return;

            _lastReloadRequestUtc = now;

            // UI スレッドで反映
            if (this.IsHandleCreated)
            {
                this.BeginInvoke(new Action(() =>
                {
                    try
                    {
                        LoadFromCsv(userDataPath);
                        RebuildNameList();
                    }
                    catch
                    {
                        // 読み取り中に他プロセスがロック中の可能性。小さくリトライしてもよい。
                    }
                }));
            }
        }

        private void Form1_FormClosed(object sender, FormClosedEventArgs e)
        {
            StopWatch();
        }

        //=== 5) 画面連携：選択した名前の電話番号を表示 ====================================
        private void NameSelected(object sender, EventArgs e)
        {
            var name = this.nameList.SelectedItem as string;
            if (string.IsNullOrEmpty(name))
            {
                this.phoneNumber.Text = string.Empty;
                return;
            }

            if (phoneBook.TryGetValue(name, out var number))
                this.phoneNumber.Text = number;
            else
                this.phoneNumber.Text = "(未登録)";
        }

        private void RebuildNameList()
        {
            // 現状の辞書から一覧を再構築（五十音/アルファベット順に）
            this.nameList.BeginUpdate();
            try
            {
                this.nameList.Items.Clear();
                foreach (var name in phoneBook.Keys.OrderBy(x => x))
                    this.nameList.Items.Add(name);
            }
            finally
            {
                this.nameList.EndUpdate();
            }
            // 選択解除
            this.phoneNumber.Text = string.Empty;
        }

        //=== 6) CSV 読み書き（簡易パース版：カンマ/ダブルクオート非対応の前提） ==========
        // → ダブルクオートやカンマが混じる可能性がある場合は、下の CsvHelper 版に置換してください。

        private void LoadFromCsv(string path)
        {
            phoneBook.Clear();

            if (!File.Exists(path)) return;

            using (var reader = new StreamReader(path, Encoding.UTF8, detectEncodingFromByteOrderMarks: true))
            {
                string line;
                while ((line = reader.ReadLine()) != null)
                {
                    if (string.IsNullOrWhiteSpace(line)) continue;
                    if (line.TrimStart().StartsWith("#")) continue;

                    // 超シンプル：最初のカンマで2分割
                    var parts = line.Split(new[] { ',' }, 2);
                    if (parts.Length < 2) continue;

                    var name = parts[0].Trim();
                    var number = parts[1].Trim();

                    if (name.Length == 0 || number.Length == 0) continue;

                    phoneBook[name] = number; // 重複は上書き方針
                }
            }
        }

        private void SaveToCsv(string path)
        {
            // UTF-8 (BOM付き) で、最低限のエスケープ（カンマ/ダブルクオート/改行があるときは二重引用符で囲む）
            using (var writer = new StreamWriter(path, false, new UTF8Encoding(encoderShouldEmitUTF8Identifier: true)))
            {
                foreach (var kv in phoneBook.OrderBy(k => k.Key))
                {
                    writer.WriteLine($"{EscapeCsv(kv.Key)},{EscapeCsv(kv.Value)}");
                }
            }
        }

        private static string EscapeCsv(string value)
        {
            if (value == null) return string.Empty;

            var needQuote = value.Contains(",") || value.Contains("\"") || value.Contains("\r") || value.Contains("\n");
            var v = value.Replace("\"", "\"\""); // ダブルクオートは2つに
            return needQuote ? $"\"{v}\"" : v;
        }

        //=== 7)（オプション）CsvHelper を使う厳密CSV版 ====================================
        // NuGet: CsvHelper を追加（.NET Framework 4.x で利用可）。
        // using CsvHelper;
        // using CsvHelper.Configuration;
        // using System.Globalization;
        //
        // ・LoadFromCsv / SaveToCsv を下の実装に差し替えると、
        //   ダブルクオートやカンマ埋め込み、改行など“正しいCSV”を安全に扱えます。

        /*
        private sealed class PhoneRecord
        {
            public string Name { get; set; }
            public string Number { get; set; }
        }

        private sealed class PhoneRecordMap : ClassMap<PhoneRecord>
        {
            public PhoneRecordMap()
            {
                Map(m => m.Name).Index(0);
                Map(m => m.Number).Index(1);
            }
        }

        private void LoadFromCsv(string path)
        {
            phoneBook.Clear();
            if (!File.Exists(path)) return;

            using (var reader = new StreamReader(path, Encoding.UTF8, true))
            using (var csv = new CsvReader(reader, CultureInfo.InvariantCulture))
            {
                csv.Configuration.HasHeaderRecord = false; // 先頭行をヘッダにしたい場合は true にしてCSV側にヘッダ行を用意
                csv.Configuration.RegisterClassMap<PhoneRecordMap>();
                foreach (var rec in csv.GetRecords<PhoneRecord>())
                {
                    if (string.IsNullOrWhiteSpace(rec?.Name) || string.IsNullOrWhiteSpace(rec?.Number)) continue;
                    phoneBook[rec.Name.Trim()] = rec.Number.Trim();
                }
            }
        }

        private void SaveToCsv(string path)
        {
            using (var writer = new StreamWriter(path, false, new UTF8Encoding(true)))
            using (var csv = new CsvWriter(writer, CultureInfo.InvariantCulture))
            {
                csv.Configuration.HasHeaderRecord = false; // ヘッダ不要
                foreach (var kv in phoneBook.OrderBy(k => k.Key))
                {
                    csv.WriteRecord(new PhoneRecord { Name = kv.Key, Number = kv.Value });
                    csv.NextRecord();
                }
            }
        }
        */
    }
}

使い方メモ

• 起動
  • 初回起動時、実行フォルダ\data.csv があれば AppData 側（%AppData%\PhoneBook\data.csv）にコピーして使用します。
  • なければ AppData 側に空の data.csv を作ります。
• Open（btnOpen）
  • 任意の CSV/TXT を選ぶと AppData 側へ上書きコピー → 即時リロード。
  • 以降は FileSystemWatcher が監視し、外部で編集しても自動反映されます。
• Save（btnSave）
  • 現在の phoneBook（画面では nameList / phoneNumber）を AppData 側の data.csv に上書き保存します。
  • 保存直後のファイル変更イベントは自己起因として無視しています（ループ防止）。
• CSVの厳密対応
  • ダブルクオートやカンマ、改行を含む値を扱う場合は、CsvHelper 版の LoadFromCsv/SaveToCsv に差し替えてください。
  • その際は NuGet で CsvHelper を追加してください。

チェックリスト

• Open → AppData にコピーされ、自動リロードも働く
• Save → 外部エディタで開いても壊れない（UTF-8/BOM）
• 外部で編集 → 数秒内に UI が更新（デバウンス済み）
• 同姓同名 → 上書き方針かスキップ方針かを明文化
• CsvHelper 版でも動作（厳密CSVが必要なチームで）

必要なら、この上に「新規追加・削除 UI」「検索」「重複検出ダイアログ」などを足すだけで、演習用のミニアプリとして十分拡張できます。