チュートリアル : データベースへのデータの保存 (単一テーブル)

[アーティクル]
02/21/2013

アプリケーション開発における最も一般的なシナリオの 1 つに、Windows アプリケーションのフォームにデータを表示して編集し、更新したデータをデータベースに返送する操作があります。このチュートリアルでは、単一のテーブルのデータを複数のコントロールに個別に表示する簡単なフォームを作成します。コントロール内でデータを編集し、変更内容をデータベースに保存できます。この例では、Northwind サンプルデータベースの Customers テーブルを使用します。

アプリケーション内のデータをデータベースに保存するには、TableAdapter の Update メソッドを呼び出します。項目を [データソース] ウィンドウからドラッグすると、データを保存するコードが、フォームにドラッグされた最初のテーブルに自動的に追加されます。さらに別のテーブルをフォームに追加した場合は、データ保存用のコードを手動で追加する必要があります。複数のテーブルからデータを保存する方法については、「チュートリアル : データベースへのデータの保存 (複数テーブル)」を参照してください。

このチュートリアルでは、以下のタスクを行います。

新しい Windows アプリケーション プロジェクトを作成します。
データソース構成ウィザードを使用して、アプリケーションにデータソースを作成して構成します。
[データソース] ウィンドウで、項目のコントロールを設定します。詳細については、「方法 : [データソース] ウィンドウからドラッグしたときに作成されるコントロールを設定する」を参照してください。
[データソース] ウィンドウからフォームに項目をドラッグして、データバインドコントロールを作成します。
データセットのいくつかのレコードを変更します。
データセット内の更新されたデータをデータベースに返送するコードを追加します。

[!メモ]

実際に画面に表示されるダイアログボックスとメニューコマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。設定を変更するには、[ツール] メニューの [設定のインポートとエクスポート] をクリックします。詳細については、「Visual Studio の設定」を参照してください。

必須コンポーネント

このチュートリアルを完了するための要件は次のとおりです。

Northwind サンプルデータベースにアクセスします。詳細については、「方法 : サンプルデータベースをインストールする」を参照してください。

Windows アプリケーションの作成

最初に Windows アプリケーションを作成します。この手順ではプロジェクトへの名前の割り当てはオプションですが、後でこのプロジェクトを保存するため、プロジェクトに名前を付けます。

新しい Windows アプリケーションプロジェクトを作成するには

[ファイル] メニューで新しいプロジェクトを作成します。
プロジェクトに UpdateSingleTableWalkthrough という名前を付けます。
[Windows アプリケーション] をクリックし、[OK] をクリックします。詳細については、「クライアントアプリケーションの開発」を参照してください。

UpdateSingleTableWalkthrough プロジェクトが作成されてソリューションエクスプローラーに追加されます。

データソースの作成

この手順では、データソース構成ウィザードを使用して、Northwind データベースからデータソースを作成します。このウィザードを実行するには、Northwind サンプルデータベースへのアクセス権を持っている必要があります。Northwind サンプルデータベースのセットアップの詳細については、「方法 : サンプルデータベースをインストールする」を参照してください。

データソースを作成するには

[データ] メニューの [データソースの表示] をクリックします。
[データソース] ウィンドウで、[新しいデータソースの追加] をクリックしてデータソース構成ウィザードを起動します。
[データソースの種類を選択] ページで、[データベース] をクリックし、[次へ] をクリックします。
[データ接続の選択] ページで、次のいずれかの操作を行います。
- Northwind サンプルデータベースへのデータ接続がドロップダウンリストに表示されている場合は選択します。
  
  または
- [新しい接続] を選択して [接続の追加] または [接続の変更] ダイアログボックスを表示します。詳細については、「[接続の追加] ダイアログボックスと [接続の変更] ダイアログボックス (一般)」を参照してください。
データベースにパスワードが必要な場合は、該当するオプションを選択して重要情報を含め、[次へ] をクリックします。
[アプリケーション構成ファイルに接続文字列を保存] ページで、[次へ] をクリックします。
[データベースオブジェクトの選択] ページの [テーブル] ノードを展開します。
Customers テーブルを選択し、[完了] をクリックします。

プロジェクトに NorthwindDataSet が追加され、[データソース] ウィンドウに Customers テーブルが表示されます。

作成するコントロールの設定

このチュートリアルでは、既定の DataGridView レイアウトの代わりに、個別のコントロールにデータが表示される [詳細] レイアウトでデータを表示します。

[データソース] ウィンドウの項目のコントロールを設定するには

[データソース] ウィンドウの [Customers] ノードを展開します。
[Customers] ノードのドロップダウンリストの [詳細] を選択して、Customers テーブルのコントロールを個別のコントロールに変更します。詳細については、「方法 : [データソース] ウィンドウからドラッグしたときに作成されるコントロールを設定する」を参照してください。

データバインドフォームの作成

[データソース] ウィンドウからフォームに項目をドラッグして、データバインディングコントロールを作成します。

フォームにデータバインディングコントロールを作成するには

[データソース] ウィンドウから Form1 にメインの [Customers] ノードをドラッグします。

説明のラベルが付いたデータバインドコントロールとレコード間を移動するためのツールストリップ (BindingNavigator) がフォームに表示されます。NorthwindDataSet、CustomersTableAdapter、BindingSource、および BindingNavigator がコンポーネントトレイに表示されます。

データベースを更新するコードの変更

CustomersTableAdapter の Update メソッドを呼び出して、データベースを更新できます。既定では、BindingNavigator の [データの保存] ボタンのイベントハンドラーが、データベースに更新を送信するフォームのコードに追加されます。この手順では、try-catch ブロックに Update 呼び出しをラップすることにより、エラー処理が含まれるようにコードを変更します。アプリケーションの要件に適合するようにコードを変更できます。

アプリケーションに更新ロジックを追加するには

BindingNavigator の [データの保存] ボタンをダブルクリックして、コードエディターで bindingNavigatorSaveItem_Click イベントハンドラーを開きます。

イベントハンドラーのコードを置き換えて、いくつかのエラー処理を追加します。コードは、次のようになります。

Try
    Me.Validate()
    Me.CustomersBindingSource.EndEdit()
    Me.CustomersTableAdapter.Update(Me.NorthwindDataSet.Customers)
    MsgBox("Update successful")

Catch ex As Exception
    MsgBox("Update failed")
End Try

try
{
    this.Validate();
    this.customersBindingSource.EndEdit();
    this.customersTableAdapter.Update(this.northwindDataSet.Customers);
    MessageBox.Show("Update successful");
}
catch (System.Exception ex)
{
    MessageBox.Show("Update failed");
}

アプリケーションのテスト

アプリケーションをテストするには

F5 キーを押します。
1 つ以上のレコードのデータを変更します。
[データの保存] をクリックします。
データベースの値をチェックし、変更が保存されたことを確認します。

次の手順

Windows アプリケーションにデータバインドフォームを作成した後で、アプリケーションの要件によってはさらに操作を追加する必要があります。このチュートリアルで行うことができる拡張には次のものがあります。

フォームに検索機能を追加できます。詳細については、「方法: パラメータークエリを Windows フォームアプリケーションに追加する」を参照してください。
関連するデータを表示するコントロールを追加します。詳細については、「方法: 関連するデータを Windows フォームアプリケーションに表示する」を参照してください。
データソースを編集し、データベースオブジェクトの追加または削除を行います。詳細については、「方法 : データセットを編集する」を参照してください。