パラメータークエリの作成

このレッスンは、LightSwitch アプリケーションで、パラメーター化されたクエリを作成する方法を示します。

パラメーター化されたクエリを作成する

パラメーター化されたクエリは、実行時に決定した 1 つ以上の値を使用して、返されるデータを決定します。たとえば、パラメーター化されたクエリは、特定のカテゴリに分類される製品のリストを返す場合があります。この場合、どのカテゴリを使用するかがパラメーターによって決定されます。これは、プログラムで決定された値に基づく場合があります。より一般的には、ユーザーが入力した値に基づいて決定されます。

パラメーター化されたクエリを作成するには

ソリューションエクスプローラーで [製品] ノードを選択します。
[プロジェクト] メニューの [クエリの追加] をクリックします。

クエリエディターが表示されます。
[プロパティ] ウィンドウで [名前] フィールドに「ProductsByCategory」と入力します。
クエリデザイナーで、[フィルターの追加] をクリックします。
最初のドロップダウンリストで [Where] を選択します。
2 番目のドロップダウンリストで [Category.CategoryID] を選択します。
3 番目のドロップダウンリストで [= (等しい)] を選択します。
4 番目のドロップダウンリストで [パラメーター] を選択します。
最後のドロップダウンリストで [新規追加] をクリックします。

タイプ Integer の CategoryID という名前の新しいパラメーターが、クエリエディターの [パラメーター] セクションに追加されます。

よく見る

このレッスンでは、製品のサブセットを返すパラメーター化されたクエリを作成する方法を示しました。実行時には [CategoryID] ボックスが提供され、ここで、ユーザーは、CategoryID パラメーターの数値を指定できます。たとえば、ユーザーがボックスで "1" を指定すると、飲料カテゴリのすべての製品が返されます。ユーザーが "2" を指定すると、調味料が返されます。

パラメーター値は、テキストボックスに入力したり、リストから選択したりできます。画面上の別のエンティティによって提供することもできます。たとえば、画面で製品を選択した場合は、同じカテゴリの他のすべての製品を返すパラメーターとして CategoryID を使用できます。