.NET Framework アプリケーションで TableAdapter DBDirect メソッドを使用してデータを保存する

注

DataSet クラスと関連クラスは、アプリケーションがデータベースから切断されている間にアプリケーションがメモリ内のデータを操作できるようにする、2000 年代初頭のレガシ .NET Framework テクノロジです。このテクノロジは、ユーザーがデータを変更し、変更をデータベースに保持できるアプリに特に役立ちます。データセットは実証済みの成功したテクノロジですが、新しい .NET アプリケーションには Entity Framework Core を使用することをお勧めします。 Entity Framework は、オブジェクトモデルとして表形式データを操作するより自然な方法を提供し、よりシンプルなプログラミングインターフェイスを備えています。

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

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

データソース構成ウィザードを使用してデータセットを作成および構成します。
[ データソース ] ウィンドウから項目をドラッグするときに、フォームに作成するコントロールを選択します。詳細については、「データソース」ウィンドウからドラッグするときに作成するコントロールを設定するを参照してください。
[データソース] ウィンドウから項目をフォームにドラッグして、データバウンドフォームを作成します。
データベースに直接アクセスし、挿入、更新、および削除を実行するメソッドを追加します。

[前提条件]

このチュートリアルの手順は、.NET Framework Windows フォームアプリケーションで動作します。

このチュートリアルでは、SQL Server Express LocalDB と Northwind サンプルデータベースを使用します。

SQL Server Express LocalDB がない場合は、 SQL Server Express のダウンロードページまたは Visual Studio インストーラーからインストールします。 Visual Studio インストーラーでは、データストレージと処理ワークロードの一部として、または個々のコンポーネントとして SQL Server Express LocalDB をインストールできます。
次の手順に従って Northwind サンプルデータベースをインストールします。
1. Visual Studio で、 SQL Server オブジェクトエクスプローラー ウィンドウを開きます。 (SQL Server オブジェクトエクスプローラーは、Visual Studio インストーラーの データストレージと処理 ワークロードの一部としてインストールされます)。 SQL Server ノードを展開します。 LocalDB インスタンスを右クリックし、[ 新しいクエリ] を選択します。
  
  クエリエディターウィンドウが開きます。
2. Northwind Transact-SQL スクリプトをクリップボードにコピーします。この T-SQL スクリプトは、Northwind データベースを最初から作成し、データを設定します。
3. T-SQL スクリプトをクエリエディターに貼り付け、[ 実行] ボタンを選択します。
  
  しばらくすると、クエリの実行が完了し、Northwind データベースが作成されます。

Windows フォームアプリケーションを作成する

最初の手順では、 Windows フォームアプリ (.NET Framework) を作成します。 C# または Visual Basic を使用して、 Windows フォームアプリ プロジェクトの種類を使用してプロジェクトを作成します。

注

このチュートリアルのコードは、C# と Visual Basic で使用できます。このページのコード言語を C# と Visual Basic の間で切り替えるには、右側のページの上部にあるコード言語スイッチャーを使用します。

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

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

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

[ データ ] メニューの [ データソースの表示] を選択します。

[ データソース] ウィンドウが開きます。
[ データソース ] ウィンドウで、[ 新しいデータソースの追加 ] を選択して 、データソース構成ウィザードを開始します。
[ データソースの種類の選択 ] 画面で、[ データベース] を選択し、[ 次へ] を選択します。
[ データ接続の選択 ] 画面で、次のいずれかの操作を行います。
- Northwind サンプルデータベースへのデータ接続がドロップダウンリストで使用できる場合は、それを選択します。
  
  -又は-
- [ 新しい接続] を選択して、[ 接続の追加/変更 ] ダイアログボックスを起動します。
データベースにパスワードが必要な場合は、機密データを含めるオプションを選択し、[ 次へ] を選択します。
[ アプリケーション構成ファイルに接続文字列を保存する] 画面で、[ 次へ] を選択します。
[ データベースオブジェクトの選択] 画面で、[ テーブル ] ノードを展開します。
Regionテーブルを選択し、[完了] を選択します。

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

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

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

Windows フォームでデータバインドコントロールを作成するには、[データソース] ウィンドウからフォームにメインの [リージョン] ノードをドラッグします。

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

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

ツールボックスから 3 つのButton コントロールを Form1 (RegionDataGridView の下) にドラッグします。
各ボタンに次の Name プロパティと Text プロパティを設定します。

名前テキスト

InsertButton 挿入

UpdateButton アップデート

DeleteButton 削除

名前	テキスト
`InsertButton`	挿入
`UpdateButton`	アップデート
`DeleteButton`	削除

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

InsertButton を選択してクリックイベントのイベントハンドラーを作成し、コードエディターでフォームを開きます。

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

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);
}

Private Sub InsertButton_Click() 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

注

Visual Studio のバージョンと使用したプロジェクトテンプレートによっては、このコードで使用される regionTableAdapter や regionTableAdapter1 などの変数名が、生成されたコードの末尾に 1 が含まれている場合とない場合があります。コード内で修正を加えて、すべての場所で正しい名前が使用されるようにします。名前が正しくない箇所では、Visual Studio により赤い波線が表示されます。

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

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

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

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();
}

Private Sub UpdateButton_Click() 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

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

DeleteButton を選択してクリックイベントのイベントハンドラーを作成し、コードエディターでフォームを開きます。

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

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

Private Sub DeleteButton_Click() Handles DeleteButton.Click

    Try
        RegionTableAdapter1.Delete(5, "Updated Region Description")

    Catch ex As Exception
        MessageBox.Show("Delete Failed")
    End Try

    RefreshDataset()
End Sub

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

F5 キーを押してアプリケーションを実行します。
[ 挿入 ] ボタンを選択し、新しいレコードがグリッドに表示されることを確認します。
[ 更新 ] ボタンを選択し、レコードがグリッドで更新されていることを確認します。
[ 削除 ] ボタンを選択し、レコードがグリッドから削除されていることを確認します。

次のステップ

アプリケーションの要件に応じて、データバインドフォームを作成した後に実行する必要がある手順がいくつかあります。このチュートリアルでは、次のような機能強化を行うことができます。

フォームに検索機能を追加する。
[データソース] ウィンドウから [ウィザードを使用してデータセットの構成] を選択して、データセットにテーブルを追加します。関連するノードをフォームにドラッグすることで、関連データを表示するコントロールを追加できます。詳細については、「データセットのリレーションシップ」を参照してください。

データをデータベースに保存し直す

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-12-12