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

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

InsertCommand、UpdateCommand、および DeleteCommand 以外に、データベースに対して直接実行できるメソッドも、TableAdapter に設定できます。これらのメソッド (TableAdapter.Insert、TableAdapter.Update、および TableAdapter.Delete) は、データベース内でデータを直接操作するために呼び出すことができます。

これらの直接メソッドを作成しない場合は、[プロパティ] ウィンドウで TableAdapter の GenerateDbDirectMethods プロパティを false に設定します。メインクエリに加えて TableAdapter に追加されたクエリは、スタンドアロンのクエリです。つまり、DbDirect メソッドを生成しないクエリです。

データベースへのコマンドの直接送信

目的とするタスクを実行する TableAdapter DbDirect メソッドを呼び出します。

新規レコードをデータベースに直接挿入するには

各列の値をパラメーターとして渡して TableAdapter の Insert メソッドを呼び出します。次の手順では、例として Northwind データベースの Region テーブルを使用します。

[!メモ]

使用できるインスタンスがない場合は、使用する TableAdapter をインスタンス化します。
```
Dim regionTableAdapter As New NorthwindDataSetTableAdapters.RegionTableAdapter

regionTableAdapter.Insert(5, "NorthWestern")
```
```
NorthwindDataSetTableAdapters.RegionTableAdapter regionTableAdapter = 
    new NorthwindDataSetTableAdapters.RegionTableAdapter();

regionTableAdapter.Insert(5, "NorthWestern");
```

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

各列の新しい値と元の値をパラメーターとして渡して TableAdapter の Update メソッドを呼び出します。

[!メモ]

使用できるインスタンスがない場合は、使用する TableAdapter をインスタンス化します。

Dim regionTableAdapter As New NorthwindDataSetTableAdapters.RegionTableAdapter

regionTableAdapter.Update(1, "East", 1, "Eastern")

NorthwindDataSetTableAdapters.RegionTableAdapter regionTableAdapter = 
    new NorthwindDataSetTableAdapters.RegionTableAdapter();

regionTableAdapter.Update(1, "East", 1, "Eastern");

データベース内のレコードを直接削除するには

各列の値を Delete メソッドのパラメーターとして渡して TableAdapter の Delete メソッドを呼び出します。この例では、Northwind データベースの Region テーブルを使用します。

[!メモ]

使用できるインスタンスがない場合は、使用する TableAdapter をインスタンス化します。
```
Dim regionTableAdapter As New NorthwindDataSetTableAdapters.RegionTableAdapter

regionTableAdapter.Delete(5, "NorthWestern")
```
```
NorthwindDataSetTableAdapters.RegionTableAdapter regionTableAdapter = 
    new NorthwindDataSetTableAdapters.RegionTableAdapter();

regionTableAdapter.Delete(5, "NorthWestern");
```