[C#] BindingNavigatorのSaveボタンの使い方

Q: データベースに変更が反映されない場合の対処法は？

データベースに変更が反映されない場合、以下の点を確認してください。 Updateメソッドが正しく呼び出されているか トランザクションが正しくコミットされているか データベース接続が正しく設定されているか データソースの変更が正しく反映されているか これらの確認を行い、必要に応じてデバッグを行うことで、問題を解決できます。

2024-09-16

BindingNavigatorのSaveボタンは、データバインディングされたデータソースの変更を保存するために使用されます。

通常、BindingNavigatorはデータベースやデータセットと連携しており、ユーザーがデータを編集した後、その変更をデータソースに反映させるためにSaveボタンを使用します。

Saveボタンのクリックイベントにイベントハンドラを追加し、その中でデータソースの更新メソッド(例えば、TableAdapter.Updateメソッド)を呼び出すことで、変更をデータベースに保存します。

これにより、ユーザーが行った変更が永続化され、次回データを読み込んだ際にも反映されます。

この記事でわかること

Saveボタンの実装方法について
複数テーブルの更新手法
トランザクションの利用方法
バリデーションの重要性
ユーザーインターフェースの改善点

目次から探す

Saveボタンの実装方法

イベントハンドラの追加

BindingNavigatorのSaveボタンを機能させるためには、まずイベントハンドラを追加する必要があります。

以下の手順で実装します。

フォームデザイナーでBindingNavigatorを選択します。
プロパティウィンドウから Events タブを開きます。
Saveボタンの Click イベントに新しいメソッドを追加します。

サンプルコードは以下の通りです。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        // SaveボタンのClickイベントにハンドラを追加
        this.bindingNavigatorSaveItem.Click += new EventHandler(this.bindingNavigatorSaveItem_Click);
    }
    private void bindingNavigatorSaveItem_Click(object sender, EventArgs e)
    {
        // Saveボタンがクリックされたときの処理をここに記述
    }
}

このコードでは、bindingNavigatorSaveItem_ClickメソッドがSaveボタンのクリックイベントに関連付けられています。

データソースの更新メソッド

Saveボタンがクリックされた際に、データソースを更新するメソッドを実装します。

通常、データベースやデータセットに対して変更を保存する処理を行います。

以下はその一例です。

private void bindingNavigatorSaveItem_Click(object sender, EventArgs e)
{
    // データソースの更新処理
    this.Validate(); // 入力値の検証
    this.myBindingSource.EndEdit(); // バインディングソースの編集を終了
    this.tableAdapterManager.UpdateAll(this.myDataSet); // データベースの更新
}

このコードでは、Validateメソッドで入力値を検証し、EndEditメソッドでバインディングソースの編集を終了させています。

最後に、UpdateAllメソッドでデータベースに変更を保存します。

エラーハンドリングの実装

データの保存処理にはエラーハンドリングが重要です。

データベースへの接続や更新時にエラーが発生する可能性があるため、try-catchブロックを使用してエラーを捕捉します。

以下のように実装します。

private void bindingNavigatorSaveItem_Click(object sender, EventArgs e)
{
    try
    {
        this.Validate(); // 入力値の検証
        this.myBindingSource.EndEdit(); // バインディングソースの編集を終了
        this.tableAdapterManager.UpdateAll(this.myDataSet); // データベースの更新
    }
    catch (Exception ex)
    {
        // エラーメッセージを表示
        MessageBox.Show("データの保存中にエラーが発生しました: " + ex.Message, "エラー", MessageBoxButtons.OK, MessageBoxIcon.Error);
    }
}

このコードでは、エラーが発生した場合にメッセージボックスでエラーメッセージを表示します。

これにより、ユーザーは何が問題だったのかを理解しやすくなります。

応用例

複数テーブルの更新

BindingNavigatorのSaveボタンを使用して、複数のテーブルを同時に更新することができます。

これには、各テーブルに対するTableAdapterを用意し、すべてのテーブルを更新する処理を実装します。

以下はその例です。

private void bindingNavigatorSaveItem_Click(object sender, EventArgs e)
{
    try
    {
        this.Validate(); // 入力値の検証
        this.myBindingSource.EndEdit(); // バインディングソースの編集を終了
        
        // 複数のテーブルを更新
        this.tableAdapter1.Update(this.myDataSet.Table1);
        this.tableAdapter2.Update(this.myDataSet.Table2);
        
        // さらに必要なテーブルがあれば追加
    }
    catch (Exception ex)
    {
        MessageBox.Show("データの保存中にエラーが発生しました: " + ex.Message, "エラー", MessageBoxButtons.OK, MessageBoxIcon.Error);
    }
}

このコードでは、tableAdapter1とtableAdapter2を使用して、2つのテーブルを更新しています。

必要に応じて、さらに多くのテーブルを追加することができます。

トランザクションの利用

データベースの整合性を保つために、トランザクションを利用することが重要です。

トランザクションを使用することで、すべての更新が成功した場合のみデータが保存され、失敗した場合はすべての変更が元に戻されます。

以下はその実装例です。

private void bindingNavigatorSaveItem_Click(object sender, EventArgs e)
{
    using (var transaction = this.myDatabaseConnection.BeginTransaction())
    {
        try
        {
            this.Validate(); // 入力値の検証
            this.myBindingSource.EndEdit(); // バインディングソースの編集を終了
            
            // トランザクション内でテーブルを更新
            this.tableAdapter1.Connection = transaction.Connection;
            this.tableAdapter1.Update(this.myDataSet.Table1);
            
            this.tableAdapter2.Connection = transaction.Connection;
            this.tableAdapter2.Update(this.myDataSet.Table2);
            
            transaction.Commit(); // トランザクションをコミット
        }
        catch (Exception ex)
        {
            transaction.Rollback(); // エラー時はロールバック
            MessageBox.Show("データの保存中にエラーが発生しました: " + ex.Message, "エラー", MessageBoxButtons.OK, MessageBoxIcon.Error);
        }
    }
}

このコードでは、トランザクションを開始し、すべての更新が成功した場合にのみコミットします。

エラーが発生した場合はロールバックを行い、データの整合性を保ちます。

バリデーションの追加

データを保存する前に、ユーザーが入力したデータのバリデーションを行うことが重要です。

これにより、不正なデータがデータベースに保存されるのを防ぎます。

以下は、簡単なバリデーションの実装例です。

private void bindingNavigatorSaveItem_Click(object sender, EventArgs e)
{
    if (string.IsNullOrWhiteSpace(this.textBoxName.Text))
    {
        MessageBox.Show("名前を入力してください。", "入力エラー", MessageBoxButtons.OK, MessageBoxIcon.Warning);
        return; // バリデーションエラーの場合は処理を中止
    }
    // それ以外の処理は省略
}

このコードでは、textBoxNameが空白でないかをチェックし、空白の場合はエラーメッセージを表示して処理を中止します。

必要に応じて、他のフィールドに対してもバリデーションを追加できます。

ユーザーインターフェースの改善

ユーザーインターフェースを改善することで、ユーザーの操作性を向上させることができます。

以下は、いくつかの改善点の例です。

スクロールできます

改善点	説明
ボタンの有効/無効化	入力が不正な場合はSaveボタンを無効化する
ツールチップの追加	各ボタンにツールチップを追加して説明を表示
フォームのレイアウト	入力フィールドをグループ化して見やすくする

これらの改善を行うことで、ユーザーがアプリケーションをより使いやすく感じることができます。

例えば、ボタンの有効/無効化は、バリデーションと連携させることで実現できます。