Création d'une requête paramétrée

Article
03/04/2013

Cette leçon indique comment créer une requête paramétrable dans une application LightSwitch.

Créer une requête paramétrée

Une requête paramétrable utilise une ou plusieurs valeurs déterminées au moment de l'exécution pour déterminer quelles données sont retournées.Par exemple, une requête paramétrable peut retourner une liste de produits appartenant à une catégorie spécifique.Dans ce cas, un paramètre détermine quelle catégorie utiliser ; il peut être basé sur une valeur déterminée par programmation, ou plus communément sur une valeur entrée par un utilisateur.

Pour créer une requête paramétrable

Dans l'Explorateur de solutions, sélectionnez le nœud Products.
Dans le menu Projet, cliquez sur Ajouter une requête.

L'Éditeur de requêtes s'ouvre.
Dans la fenêtre Propriétés, dans le champ Nom, tapez ProductsByCategory.
Dans le Concepteur de requêtes, cliquez sur Ajouter un filtre.
Dans la première liste déroulante sélectionnez Where.
Dans la deuxième liste déroulante, sélectionnez Category.CategoryID.
Dans la troisième liste déroulante, sélectionnez = (égal).
Dans la quatrième liste déroulante, sélectionnez Paramètre.
Dans la dernière liste déroulante, cliquez sur Ajouter.

Un nouveau paramètre nommé CategoryID, de type Integer est ajouté à la section Paramètres de l'Éditeur de requêtes.

Présentation détaillée

Cette leçon a indiqué comment créer une requête paramétrée qui retourne un sous-ensemble de produits.Au moment de l'exécution, une zone CategoryID est fournie afin qu'un utilisateur puisse spécifier une valeur numérique pour le paramètre CategoryID.Par exemple, si l'utilisateur spécifie 1 dans la zone, tous les produits de la catégorie Beverages seront retournés.Si l'utilisateur spécifie 2, les Condiments seront retournés.

La valeur de paramètre peut être tapée dans une zone de texte ou sélectionnée dans une liste.Elle peut également être fournie par une autre entité sur un écran.Par exemple, lorsqu'un produit est sélectionné sur un écran, vous pouvez utiliser son CategoryID comme paramètre pour retourner tous les autres produits de la même catégorie.