方法: パラメーター クエリを Windows フォーム アプリケーションに追加する
パラメーター クエリを実行すると、Windows アプリケーションのフォームに検索機能を追加できます。 パラメーター クエリは、WHERE 句の条件を満たすデータを返します。 [検索条件ビルダー] ダイアログ ボックスの設定を完了すると、クエリにパラメーターが追加されます。 たとえば、クエリをパラメーター化して、顧客の一覧を返す SQL ステートメントの最後に WHERE City = @City を追加すると、特定の都市の顧客のみを表示できます。 詳細については、「パラメーター クエリ」を参照してください。
[検索条件] ダイアログ ボックスの設定が完了すると、次の操作が行われます。
関連する TableAdapter にクエリが追加されます。
ユーザーが必要なパラメーター値を指定するためのコントロールと、クエリを実行するためのボタンがフォームに追加されます。
パラメーター値を設定してクエリを実行するコードが、ボタンのクリック イベントに追加されます。
注意
実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。 設定を変更するには、[ツール] メニューの [設定のインポートとエクスポート] をクリックします。 詳細については、「設定の操作」を参照してください。
既存のデータ バインド フォームにクエリを追加するには
Windows フォーム デザイナーでフォームを開きます。
[データ] メニューまたはデータ スマート タグの [クエリの追加] をクリックします。
注意
[データ] メニューの [クエリの追加] が利用できない場合は、フォーム上の、パラメーターを追加するデータ ソースが表示されているコントロールを選択します。 たとえば、フォームで DataGridView コントロールにデータが表示されている場合は、そのコントロールを選択します。 フォームの個々のコントロールにデータが表示されている場合は、任意のデータ バインド コントロールを選択します。
[データ ソース テーブルを選択してください] 領域で、パラメーターを追加するテーブルを選択します。 詳細については、「[検索条件ビルダー] ダイアログ ボックス」を参照してください。
新しいクエリを作成する場合は、[新しいクエリ名] ボックスに名前を入力します。
または
[既存のクエリ名] ボックスでクエリを選択します。
[クエリ テキスト] ボックスに、パラメーターを使用するクエリを入力します。
ヒント
クエリ ビルダーは、クエリを作成する際に役立ちます。 詳細については、「クエリおよびビュー デザイナー ツール」を参照してください。
[OK] をクリックします。
パラメーター入力用のコントロールと [読み込み] ボタンが、ToolStrip コントロールのフォームに追加されます。
参照
処理手順
チュートリアル: データを検索する Windows フォームの作成
方法 : Windows フォーム BindingNavigator コントロールを使用してデータ間を移動する
方法 : Windows フォーム BindingSource コンポーネントで ADO.NET データを並べ替える/フィルター処理する
方法 : Windows フォーム BindingSource コンポーネントを使用してルックアップ テーブルを作成する