チュートリアル : TableAdapter DBDirect メソッドを使用してデータを保存する

更新 : 2007 年 11 月

このチュートリアルでは、TableAdapter の DBDirect メソッドを使用して、データベースに対して直接 SQL ステートメントを実行する手順を詳しく説明します。TableAdapter の DBDirect メソッドを使用すると、データベースの更新を細かく制御できます。これらのメソッドを使用すると、UPDATE、INSERT、および DELETE ステートメントを単独の呼び出しで実行するオーバーロードされた Update メソッドとは異なり、必要に応じてアプリケーションで Insert、Update、および Delete メソッドを個別に呼び出すことによって、特定の SQL ステートメントおよびストアド プロシージャを実行できます。

このチュートリアルでは、次の作業を行う方法について説明します。

• 新しい Windows アプリケーションを作成します。

• データ ソース構成ウィザードを使用して、データセットを作成して構成します。

• [データ ソース] ウィンドウから項目をドラッグしたときにフォーム上に作成するコントロールを選択します。詳細については、「方法 : [データ ソース] ウィンドウからドラッグしたときに作成されるコントロールを設定する」を参照してください。

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

• データベースに直接アクセスし、データベースに対して直接挿入、更新、および削除を実行するメソッドを追加します。

前提条件

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

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

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

最初に Windows アプリケーションを作成します。

新しい Windows プロジェクトを作成するには

1. Visual Studio の [ファイル] メニューの [新しいプロジェクト] をクリックします。

2. プロジェクトに TableAdapterDbDirectMethodsWalkthrough という名前を付けます。

3. [Windows アプリケーション] をクリックし、[OK] をクリックします。詳細については、「Windows ベースのアプリケーションの作成」を参照してください。

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

データベースからデータ ソースを作成する

この手順では、データ ソース構成ウィザードを使用して、Northwind サンプル データベースの Region テーブルに基づいてデータ ソースを作成します。接続を作成するには、Northwind サンプル データベースにアクセスできる必要があります。Northwind サンプル データベースのセットアップの詳細については、「方法 : サンプル データベースをインストールする」を参照してください。

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

1. [データ] メニューの [データ ソースの表示] をクリックします。

2. [データ ソース] ウィンドウで、[新しいデータ ソースの追加] をクリックしてデータ ソース構成ウィザードを起動します。

3. [データソースの種類を選択] ページで、[データベース] をクリックし、[次へ] をクリックします。

4. [データ接続の選択] ページで、次のいずれかの操作を行います。

   • Northwind サンプル データベースへのデータ接続がドロップダウン リストに表示されている場合は選択します。

     または

   • [新しい接続] を選択して [接続の追加] または [接続の変更] ダイアログ ボックスを表示します。詳細については、「[接続の追加] ダイアログ ボックスと [接続の変更] ダイアログ ボックス (一般)」を参照してください。

5. データベースにパスワードが必要な場合は、該当するオプションを選択して重要情報を含め、[次へ] をクリックします。

6. [アプリケーション構成ファイルに接続文字列を保存] ページで、[次へ] をクリックします。

7. [データベース オブジェクトの選択] ページの [テーブル] ノードを展開します。

8. Region テーブルを選択し、[完了] をクリックします。

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

フォームにコントロールを追加してデータを表示する

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

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

• [データ ソース] ウィンドウからフォームにメインの [Region] ノードをドラッグします。

  レコード間をナビゲートするための DataGridView コントロールとツール ストリップ (BindingNavigator) がフォームに表示されます。NorthwindDataSet、RegionTableAdapter、BindingSource、および BindingNavigator がコンポーネント トレイに表示されます。

TableAdapter DbDirect の個々のメソッドを呼び出すボタンを追加するには

1. ツールボックスから 3 つの Button コントロールを RegionDataGridView の下の Form1 にドラッグします。

2. 各ボタンの [Name] と Text プロパティを設定します。

   Name	Text
   InsertButton	Insert
   UpdateButton	Update
   DeleteButton	Delete

新しいレコードをデータベースに挿入するコードを追加するには

1. [InsertButton] をダブルクリックしてクリック イベントのイベント ハンドラを作成し、コード エディタでフォームを開きます。

2. InsertButton_Click イベント ハンドラを次のコードで置き換えます。

   Private Sub InsertButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
       Handles InsertButton.Click
   
       Dim newRegionID As Integer = 5
       Dim newRegionDescription As String = "NorthEastern"
   
       Try
           RegionTableAdapter1.Insert(newRegionID, newRegionDescription)
   
       Catch ex As Exception
           MessageBox.Show("Insert Failed")
       End Try
   
       RefreshDataset()
   End Sub
   
   
   Private Sub RefreshDataset()
       Me.RegionTableAdapter1.Fill(Me.NorthwindDataSet1._Region)
   End Sub
   

   private void InsertButton_Click(object sender, EventArgs e)
   {
       Int32 newRegionID = 5;
       String newRegionDescription = "NorthEastern";
   
       try
       {
           regionTableAdapter1.Insert(newRegionID, newRegionDescription);
       }
       catch (Exception ex)
       {
           MessageBox.Show("Insert Failed");
       }
       RefreshDataset();
   }
   
   
   private void RefreshDataset()
   {
       this.regionTableAdapter1.Fill(this.northwindDataSet1.Region);
   }
   

データベースのコードを更新するコードを追加するには

1. [UpdateButton] をダブルクリックしてクリック イベントのイベント ハンドラを作成し、コード エディタでフォームを開きます。

2. UpdateButton_Click イベント ハンドラを次のコードで置き換えます。

   Private Sub UpdateButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
       Handles UpdateButton.Click
   
       Dim newRegionID As Integer = 5
   
       Try
           RegionTableAdapter1.Update(newRegionID, "Updated Region Description", 5, "NorthEastern")
   
       Catch ex As Exception
           MessageBox.Show("Update Failed")
       End Try
   
       RefreshDataset()
   End Sub
   

   private void UpdateButton_Click(object sender, EventArgs e)
   {
       Int32 newRegionID = 5;
   
       try
       {
           regionTableAdapter1.Update(newRegionID, "Updated Region Description", 5, "NorthEastern");
       }
       catch (Exception ex)
       {
           MessageBox.Show("Update Failed");
       }
       RefreshDataset();
   }
   

データベースからレコードを削除するコードを追加するには

1. [DeleteButton] をダブルクリックしてクリック イベントのイベント ハンドラを作成し、コード エディタでフォームを開きます。

2. DeleteButton_Click イベント ハンドラを次のコードで置き換えます。

   Private Sub DeleteButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
       Handles DeleteButton.Click
   
       Try
           RegionTableAdapter1.Delete(5, "Updated Region Description")
   
       Catch ex As Exception
           MessageBox.Show("Delete Failed")
       End Try
   
       RefreshDataset()
   End Sub
   

   private void DeleteButton_Click(object sender, EventArgs e)
   {
       try
       {
           regionTableAdapter1.Delete(5, "Updated Region Description");
       }
       catch (Exception ex)
       {
           MessageBox.Show("Delete Failed");
       }
       RefreshDataset();
   }
   

アプリケーションの実行

アプリケーションを実行するには

• F5 キーを押してアプリケーションを実行します。

• [挿入] ボタンをクリックし、グリッドに新しいレコードが表示されることを確認します。

• [更新] ボタンをクリックし、グリッドのレコードが更新されていることを確認します。

• [削除] ボタンをクリックし、グリッドからレコードが削除されていることを確認します。

次の手順

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

• フォームに検索機能を追加できます。詳細については、「方法 : パラメータ クエリを Windows アプリケーションのフォームに追加する」を参照してください。

• [データ ソース] ウィンドウの [ウィザードで DataSet を構成] をクリックして、テーブルをデータセットに追加できます。関連するノードをフォームにドラッグすることによって、関連するデータを表示するコントロールを追加できます。詳細については、「方法 : 関連するデータを Windows アプリケーションに表示する」を参照してください。

参照

処理手順

方法 : TableAdapter で直接データベースにアクセスする

方法 : TableAdapter クエリを作成する

方法 : オブジェクトからデータベースにデータを保存する

概念

TableAdapter の概要

データの表示の概要

その他の技術情報

Visual Studio でのデータへの接続

アプリケーションでデータを受け取る準備

アプリケーションへのデータのフェッチ

Windows アプリケーションのフォームでのデータの表示

アプリケーションでのデータ編集

データの検証

データの保存