Utilisation d'une requête paramétrée sur un écran

Article
03/04/2013

Dans cette leçon, vous apprendrez comment utiliser une requête paramétrable sur un écran pour filtrer les données.

À l'aide d'une requête paramétrée

Dans la dernière leçon, vous avez créé une requête pour filtrer des produits selon un paramètre CategoryID.Au moment de l'exécution, ce paramètre peut être utilisé pour appliquer le filtre à une autre entité qui contient un champ CategoryID.Par exemple, vous pouvez utiliser la requête paramétrable pour afficher une liste des produits correspondant à la catégorie d'un produit sélectionné dans une liste sur l'écran.

La valeur de paramètre peut être fournie au moment du design comme propriété dans le Concepteur d'écran ou par l'utilisateur au moment de l'exécution.Dans cet exemple, vous assignerez la valeur au moment du design.

Pour ajouter une requête paramétrable à un écran

Dans l'explorateur de solutions, double-cliquez sur le nœud d'écran CurrentProductList.
Dans le Concepteur d'écran, cliquez sur le bouton de barre d'outils Ajouter un élément de données.

La boîte de dialogue Ajouter un élément de données s'affiche.
Dans la boîte de dialogue Ajouter un élément de données, cliquez sur Requête.
Dans la colonne Nom, sélectionnez NorthwindEntitiesData.ProductsByCategory, puis cliquez sur OK.

Un nœud ProductsByCategoryCollection est ajouté au volet de gauche.
Sous le nœud Paramètres de la requête, sélectionnez CategoryID.
Dans la fenêtre Propriétés, sélectionnez Liaison de paramètre et tapez CurrentProducts.SelectedItem.Category.CategoryID.
Dans le Concepteur d'écran, sélectionnez le nœud Disposition des lignes | Colonne des détails.
Cliquez sur Ajouter et sélectionnez ProductsByCategory dans la liste déroulante.

Un nouveau nœud DataGrid | ProductsByCategory s'affiche dans l'arborescence de contenu de l'écran.
Appuyez sur F5 pour exécuter l'application et consulter les résultats.

Lorsque vous ouvrez l'écran CurrentProductList, notez que tous les produits ayant le même CategoryID que le produit actuellement sélectionné sont affichés dans la nouvelle grille.

Présentation détaillée

Dans cette procédure, vous avez utilisé la requête paramétrable que vous avez créée dans la dernière leçon pour afficher une liste de produits.La requête a été ajoutée à un écran existant, l'écran CurrentProductList.La propriété Valeur du paramètre de la requête spécifie la valeur CategoryID du ProductCollection existant sur l'écran et fournit le paramètre au moment de l'exécution.Par conséquent, une liste des produits ayant un CategoryID correspondant est affichée chaque fois qu'un produit est sélectionné dans la liste ProductCollection.