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

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

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

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

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

[!メモ]

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

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

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

[!メモ]

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

または

[既存のクエリ名] ボックスでクエリを選択します。

[クエリテキスト] ボックスに、パラメーターを使用するクエリを入力します。

ヒント
クエリビルダーは、クエリを作成する際に役立ちます。詳細については、「クエリおよびビューデザイナーツール」を参照してください。