方法 : TableAdapter クエリを実行する

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

TableAdapter クエリはアプリケーションがデータベースに対して実行できる SQL ステートメントまたはストアドプロシージャで、TableAdapter で型指定されたメソッドとして公開されます。TableAdapter クエリは、あらゆるオブジェクトのメソッドと同様に、関連付けられたメソッドを呼び出すことによって実行できます。

TableAdapter クエリは、データテーブルに値を設定したり (Fill クエリと FillBy クエリ)、クエリが返すデータを読み込んだ新しいデータテーブルを返すことができます (GetData クエリと GetDataBy クエリ)。

TableAdapter クエリの構成ウィザードを実行すると、クエリを既存の TableAdapter に追加できます。

TableAdapter のインスタンスの作成

TableAdapter のメソッドを呼び出す前に、TableAdapter のインスタンスを作成する必要があります。

[!メモ]

TableAdapter はデータセットデザイナーを使用して作成および編集しますが、TableAdapter は実際にはデータセット内で入れ子になったクラスではありません。TableAdapter は TableAdapter に関連付けられ、データセット名に基づいて指定された名前空間にあります。名前付け規則は、DataSetName + "TableAdapters" です。たとえば、NorthwindDataSet に関連付けられたすべての TableAdapter は NorthwindDataSetTableAdapters 名前空間にあります。CustomersTableAdapter があるとすると、その完全修飾名は NorthwindDataSetTableAdapters.CustomersTableAdapter になります。

TableAdapter のインスタンスを作成するには

[データソース] ウィンドウから項目を Windows アプリケーションのフォームにドラッグすると、フォームに TableAdapter のインスタンスが自動的に作成されます。フォームの下部の境界の下の小さな領域にあるコンポーネントトレーの TableAdapter を調べて、インスタンスの名前を確認します。

または
TableAdapter を作成した後にプロジェクトを構築します。TableAdapter がツールボックスに表示されます。ツールボックスから TableAdapter をフォームにドラッグしてインスタンスを作成します。コンポーネントトレーの TableAdapter を調べて、インスタンスの名前を確認します。

または

TableAdapter のインスタンスをプログラムによって作成します。

Dim CustomersTableAdapter1 As NorthwindDataSetTableAdapters.CustomersTableAdapter
CustomersTableAdapter1 = New NorthwindDataSetTableAdapters.CustomersTableAdapter()

NorthwindDataSetTableAdapters.CustomersTableAdapter customersTableAdapter1;
customersTableAdapter1 = new NorthwindDataSetTableAdapters.CustomersTableAdapter();

既存のデータテーブルにデータを読み込む TableAdapter クエリの実行 (Fill() のメソッド)

既存のデータテーブルにデータを読み込む TableAdapter クエリを実行するには

TableAdapter の Fill クエリまたは FillBy クエリを呼び出し、データを読み込むデータテーブルを渡します。たとえば、次のコードは Fill クエリを実行して Customers テーブルにデータを読み込みます。
```
CustomersTableAdapter1.Fill(NorthwindDataSet1.Customers)
```
```
customersTableAdapter1.Fill(northwindDataSet1.Customers);
```

新しいデータテーブルを返す TableAdapter クエリの実行 (GetData() のメソッド)

新しいデータテーブルを返す TableAdapter クエリを実行するには

TableAdapter の GetData クエリまたは GetDataBy クエリを呼び出し、クエリの結果が格納され、型指定されたデータテーブルを返します。たとえば、次のコードは GetData クエリを実行して Customers テーブルを返します。
```
Dim newCustomersTable As NorthwindDataSet.CustomersDataTable
newCustomersTable = CustomersTableAdapter1.GetData()
```
```
NorthwindDataSet.CustomersDataTable newCustomersTable;
newCustomersTable = customersTableAdapter1.GetData();
```

単一 (スカラー) 値を返す TableAdapter クエリの実行

ツールボックスから直接データセットデザイナーにクエリをドラッグして、スタンドアロンクエリ (データテーブルを使用しないクエリ) を作成できます。

単一 (スカラー) 値を返す TableAdapter クエリを実行するには

TableAdapter のインスタンスを作成し、戻り値を保持する変数を宣言し、クエリの結果を代入します。次の例は、QueriesTableAdapter に対する CustomerCount というクエリがあると仮定しています。

Dim scalarQueriesTableAdapter As NorthwindDataSetTableAdapters.QueriesTableAdapter
scalarQueriesTableAdapter = New NorthwindDataSetTableAdapters.QueriesTableAdapter()

Dim returnValue As Integer
returnValue = CType(scalarQueriesTableAdapter.CustomerCount(), Integer)

NorthwindDataSetTableAdapters.QueriesTableAdapter scalarQueriesTableAdapter;
scalarQueriesTableAdapter = new NorthwindDataSetTableAdapters.QueriesTableAdapter();

int returnValue;
returnValue = (int)scalarQueriesTableAdapter.CustomerCount();