方法 : TableAdapter クエリを作成する
更新 : 2007 年 11 月
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 を右クリックし、[クエリの追加] をクリックします。
.gif "メモ") メモ : |
|---|
使用している設定またはエディションによっては、表示されるダイアログ ボックスやメニュー コマンドがヘルプに記載されている内容と異なる場合があります。設定を変更するには、[ツール] メニューの [設定のインポートとエクスポート] をクリックします。詳細については、「Visual Studio の設定」を参照してください。 |
データセット デザイナでのクエリの作成
データセット デザイナで TableAdapter にクエリを追加するには
データセット デザイナでデータセットを開きます。詳細については、「方法 : データセット デザイナでデータセットを開く」を参照してください。
目的の TableAdapter を右クリックし、[クエリの追加] をクリックします。
または
ツールボックスの [データセット] タブからデザイナ上のテーブルに [Query] をドラッグします。
TableAdapter クエリの構成ウィザードが開きます。
ウィザードが完了し、TableAdapter にクエリが追加されます。
Windows アプリケーションのフォームにおけるクエリの直接作成
フォーム上に TableAdapter のインスタンスがある場合、[検索条件ビルダ] ダイアログ ボックスを使用してクエリを追加できます。この場合、クエリに必要な入力パラメータを受け取る ToolStrip コントロール、およびクエリを実行するボタンが、フォームに追加されます。
[検索条件] ダイアログ ボックスを使用して TableAdapter にクエリを追加するには
コンポーネント トレイで TableAdapter を選択します。
TableAdapter のスマート タグをクリックし、[クエリの追加] をクリックします。
ダイアログ ボックスに必要な項目を入力すると、TableAdapter にクエリが追加されます。詳細については、「[検索条件ビルダ] ダイアログ ボックス」を参照してください。
参照
処理手順
方法 : Windows フォーム BindingNavigator コントロールを使用してデータ間を移動する
チュートリアル : Windows アプリケーションのフォームでのデータの表示