方法 : パラメーター付きの TableAdapter クエリを作成する
公開日: 2016年4月
パラメーター クエリは、クエリ内の WHERE 句の条件を満たすデータを返します。 たとえば、顧客リストをパラメーター化して、顧客のリストを戻す SQL ステートメントに WHERE City = @City
を追加することで、特定の都市の顧客のみが表示されるようにできます。
パラメーター化された TableAdapter クエリは、データセット デザイナーで作成するか、または Windows アプリケーションでデータ バインド フォームを作成するときに [データ] メニューの [データ ソースのパラメーター化] を使用して作成します。 [データ ソースのパラメーター化] コマンドによって、パラメーター値を入力してクエリを実行するためのコントロールもフォームに作成されます。 詳細については、「ダイアログ ボックス」を参照してください。
注意
パラメーター クエリを作成するときには、コーディングで対象とするデータベースに固有のパラメーター表記を使用します。 たとえば、Access データ ソースと OleDb データ ソースは疑問符 "?" を使用してパラメーターを表すため、WHERE 句は WHERE City = ?
のようになります。
注意
実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。 設定を変更するには、[ツール] メニューの [設定のインポートとエクスポート] をクリックします。 詳細については、「Customizing Development Settings in Visual Studio」を参照してください。
パラメーター化された TableAdapter クエリの作成
データセット デザイナーでパラメーター クエリを作成するには
新しい TableAdapter を作成し、目的のパラメーターを含む WHERE 句を SQL ステートメントに追加します。 詳細については、「方法 : TableAdapter を作成する」を参照してください。
または
既存の TableAdapter にクエリを追加し、目的のパラメーターを含む WHERE 句を SQL ステートメントに追加します。 詳細については、「方法 : TableAdapter クエリを作成する」を参照してください。
データ バインド フォームの設計時にパラメーター クエリを作成するには
フォーム上の既にデータセットにバインドされているコントロールを選択します。 詳細については、「Visual Studio でのデータへの Windows フォーム コントロールのバインド」を参照してください。
[データ] メニューの [クエリの追加] をクリックします。
[検索条件ビルダー] ダイアログ ボックスの設定を完了し、目的のパラメーターを含む WHERE 句を SQL ステートメントに追加します。 詳細については、「ダイアログ ボックス」を参照してください。
参照
TableAdapter
Visual Studio でのデータへの接続
アプリケーションでデータを受け取る準備
アプリケーションへのデータのフェッチ
Visual Studio でのデータへのコントロールのバインド
アプリケーションでのデータ編集
データの検証
データの保存
データに関するチュートリアル