次の方法で共有


方法 : 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 フォーム コントロールのバインド

型指定されたデータセットの作成と編集

データ ソースの概要

データの検証