Share via

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

  • [アーティクル]

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

参照

処理手順

方法 : TableAdapter を作成する

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

方法 : TableAdapter クエリを編集する

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

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

方法 : Windows フォーム BindingNavigator コントロールを使用してデータ間を移動する

チュートリアル: Windows フォームでのデータの表示

概念

TableAdapter の概要

Visual Studio でのデータへの Windows フォーム コントロールのバインド

データセット デザイナー

データ ソースの概要

その他の技術情報

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

データの検証