方法: パラメータークエリを Windows フォームアプリケーションに追加する

[アーティクル]
09/12/2015

パラメータークエリを実行することによって、Windows アプリケーションのフォームに検索機能を追加できます。パラメータークエリは、WHERE 句の条件を満たすデータを返します。クエリにパラメーター化を追加するには、[検索条件ビルダー] ダイアログボックスの設定を完了します。たとえば、クエリをパラメーター化して、顧客のリストを戻す SQL ステートメントに WHERE City = @City を追加することで、特定の都市の顧客のみが表示されるようにできます。

[検索条件] ダイアログボックスの設定が完了すると、次の処理が実行されます。

関連する TableAdapter にクエリが追加されます。
ユーザーが必要なパラメーター値を指定するためのコントロールと、クエリを実行するためのボタンがフォームに追加されます。
パラメーター値を設定し、クエリを実行するコードがボタンのクリックイベントに追加されます。

注意

実際に画面に表示されるダイアログボックスとメニューコマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。設定を変更するには、[ツール] メニューの [設定のインポートとエクスポート] をクリックします。詳細については、「Customizing Development Settings in Visual Studio」を参照してください。

既存のデータバインドフォームにクエリを追加するには

Windows フォームデザイナーでフォームを開きます。
[データ] メニューまたは [データスマートタグ] の [クエリの追加] をクリックします。

注意

[データ] メニューの [クエリの追加] が使用できない場合は、パラメーターの追加先のデータソースを表示するフォーム上のコントロールを選択します。たとえば、フォームに DataGridView コントロールのデータが表示される場合は、そのコントロールを選択します。フォームに個々のコントロールのデータが表示される場合は、いずれかのデータバインドコントロールを選択します。
[データソーステーブルを選択してください] 領域でパラメーターの追加先のテーブルを選択します。詳細については、「[検索条件ビルダー] ダイアログボックス」を参照してください。
新しいクエリを作成する場合は、[新しいクエリ名] ボックスに名前を入力します。

または

[既存のクエリ名] ボックスでクエリを選択します。
[クエリテキスト] ボックスにパラメーターを使用するクエリを入力します。
[OK] をクリックします。

パラメーターを入力するコントロールと [読み込み] ボタンが ToolStrip コントロールのフォームに追加されます。