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

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

TableAdapter クエリは、アプリケーションからデータベースに対して実行できる SQL ステートメントまたはストアドプロシージャです。

1 つの TableAdapter に、アプリケーションで必要な数のクエリを追加できます。TableAdapter クエリは、TableAdapter のメソッドとして表されます。市の値を表すパラメーターを受け取る FillByCity という名前のクエリを作成したとして、そのクエリを TableAdapter に追加します。これは、正しい型のパラメーター (この場合は市の値を表す文字列) を引数として受け取る、型指定されたメソッドとして追加されます。TableAdapter クエリは、オブジェクトのメソッドの場合と同様に呼び出します。たとえば、以下のコードは、FillByCity クエリを実行して、市の値が Seattle である顧客すべてを Customers テーブルに格納します。

Dim cityValue As String = "Seattle"
CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, cityValue)

string cityValue = "Seattle";
customersTableAdapter.FillByCity(northwindDataSet.Customers, cityValue);

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

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

[!メモ]

お使いのマシンで、Visual Studio ユーザーインターフェイスの一部の要素の名前や場所が、次の手順とは異なる場合があります。これらの要素は、使用している Visual Studio のエディションや独自の設定によって決まります。詳細については、「Visual Studio の設定」を参照してください。

データセットデザイナーでのクエリの作成

データセットデザイナーで TableAdapter にクエリを追加するには

データセットデザイナーでデータセットを開きます。詳細については、「方法 : データセットデザイナーでデータセットを開く」を参照してください。
目的の TableAdapter を右クリックし、[クエリの追加] をクリックします。

または
ツールボックスの [データセット] タブからデザイナー上のテーブルに [Query] をドラッグします。

TableAdapter クエリの構成ウィザードが開きます。
ウィザードが完了し、TableAdapter にクエリが追加されます。

Windows アプリケーションのフォームにおけるクエリの直接作成

フォーム上に TableAdapter のインスタンスがある場合、[検索条件ビルダー] ダイアログボックスを使用してクエリを追加できます。この場合、クエリに必要な入力パラメーターを受け取る ToolStrip コントロール、およびクエリを実行するボタンが、フォームに追加されます。

[検索条件] ダイアログボックスを使用して TableAdapter にクエリを追加するには

コンポーネントトレイで TableAdapter を選択します。
TableAdapter のスマートタグをクリックし、[クエリの追加] をクリックします。
ダイアログボックスに必要な項目を入力すると、TableAdapter にクエリが追加されます。詳細については、「[検索条件ビルダー] ダイアログボックス」を参照してください。