DataGridViewで作る簡易レジアプリ｜プロジェクト作成から学ぶC#実践課題

デザイナーで設定する場合

1. フォーム上の DataGridView を選択
2. 右上のタスクメニューから「列の編集」を選択
3. 「追加」ボタンで列を4つ作成し、Name（内部の名前）を ProductName／Price／Quantity／Subtotal、HeaderText（見出し）を「商品名」／「単価」／「数量」／「小計」に設定

コードで設定する場合

dataGridView1.Columns.Add("ProductName", "商品名");
dataGridView1.Columns.Add("Price", "単価");
dataGridView1.Columns.Add("Quantity", "数量");
dataGridView1.Columns.Add("Subtotal", "小計");

解説

• Columns.Add(列名, 表示テキスト) の第1引数は内部的な識別名（英数字推奨）、第2引数が画面に表示されるヘッダー文字列です。この区別を最初に理解しておくと、後でコードから特定の列を参照する際（dataGridView1.Columns["Price"] など）につまずきません。
• デザイナーとコード、どちらで設定しても結果は同じです。初学者にはまずデザイナーで視覚的に理解してもらい、その後コードでも同じことができると示すと納得感が生まれます。
• 列の順番は Add した順（またはデザイナーでの並び順）がそのまま表示順になります。

// Product.csに記述（Form1と同じ名前空間に置く）
class Product
{
    public string Name { get; set; } = "";
    public int Price { get; set; }
    public int Quantity { get; set; }
    public int Subtotal => Price * Quantity;
}

// ここからはForm1のコンストラクター内に記述
// InitializeComponent()と列の準備の後で実行する
List<Product> products = new List<Product>
{
    new Product { Name = "コーヒー", Price = 150, Quantity = 2 },
    new Product { Name = "パン", Price = 180, Quantity = 1 },
    new Product { Name = "おにぎり", Price = 130, Quantity = 3 }
};

// 再表示する場合にも行が重複しないよう、表示中の行を消す
dataGridView1.Rows.Clear();
foreach (var p in products)
{
    dataGridView1.Rows.Add(p.Name, p.Price, p.Quantity, p.Subtotal);
}

解説

• Subtotal を保存用のフィールドではなく => を使った計算プロパティにしている点がポイントです。Product の単価や数量が変わっても、プロパティを参照するたびに小計を計算します。ただし、この例の Rows.Add は値を画面にコピーするため、表示済みのセルは自動更新されません。変更後は行をクリアして、foreach でもう一度表示します。
• List<Product> にデータをまとめることで、「商品データの管理」と「画面への表示」が別々の処理になります。これはステップ2の書き方（Rows.Add を直接並べる）との大きな違いです。
• foreach でリストをループし、1件ずつ DataGridView に反映させる流れは、「データと画面表示を分けて考える」設計につながります。ステップ4では、手動で行を追加する処理をデータバインディングに置き換えます。
• Name は空文字列で初期化し、Nullable参照型が有効な環境でも未初期化の警告が出ないようにしています。
• 応用として、products をフォームのフィールドに移し、商品追加ボタンで Add した後に行をクリアして再表示する機能へ発展できます。Refresh() で画面を描き直すだけでは、リストの変更は反映されません。

// 以前の表示を解除し、手動追加した行と列を取り除く
dataGridView1.DataSource = null;
dataGridView1.Rows.Clear();
dataGridView1.Columns.Clear();
dataGridView1.AutoGenerateColumns = true;

// DataTableを準備
DataTable table = new DataTable();
table.Columns.Add("商品名", typeof(string));
table.Columns.Add("単価", typeof(int));
table.Columns.Add("数量", typeof(int));
table.Columns.Add("小計", typeof(int));

// 行を追加
table.Rows.Add("コーヒー", 150, 2, 300);
table.Rows.Add("パン", 180, 1, 180);
table.Rows.Add("おにぎり", 130, 3, 390);

// DataGridViewにバインド
dataGridView1.DataSource = table;

解説

• DataTable はメモリ上に「表形式のデータ」を保持する入れ物です。列（Columns）と行（Rows）を持つ点は DataGridView と似ていますが、あくまでデータそのものを管理するオブジェクトである点が違います。
• dataGridView1.DataSource = table; の1行で、DataTable の内容がそのまま画面に反映されます。行を追加・削除するときも table.Rows.Add(...) や table.Rows.RemoveAt(...) のようにデータ側を操作するだけでよく、DataGridView の行を直接追加・削除する必要がありません。バインド後は dataGridView1.Rows.Add(...) を使わず、table.Rows.Add(...) を使います。
• このサンプルの「小計」は固定値です。ステップ3の計算プロパティとは異なり、単価や数量を変更しても自動再計算されません。自動計算に発展させる場合は、小計列に table.Columns["小計"]!.Expression = "[単価] * [数量]"; を設定し、行追加では小計を渡さず table.Rows.Add("コーヒー", 150, 2); のように先頭3列だけを指定します。! は直前に追加した列が存在することをコンパイラーに伝える記号です。
• これは「データと画面表示を分ける設計」の第一歩です。将来的にデータベースアクセスや、データバインディングを利用した画面づくりを学ぶ際の土台になります。
• ステップ3の List<Product> との違いにも触れておくと理解が深まります。List<Product> は自分で定義したクラスの集合、DataTable は汎用的な表形式データという位置づけです。この例では、Product のリストを自動変換しているわけではなく、同じ商品を DataTable に作り直しています。DBやCSVから読み込んだデータも表形式で扱えますが、読み込み処理は別途必要です。