方法 : TableAdapter クエリを作成する
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 にクエリが追加されます。詳細については、「[検索条件ビルダー] ダイアログ ボックス」を参照してください。
参照
処理手順
方法 : Windows フォーム BindingNavigator コントロールを使用してデータ間を移動する
チュートリアル : 複数のクエリによる TableAdapter の作成