Création d'une requête de base

Article
03/04/2013

Cette leçon indique comment créer une requête LightSwitch qui retourne un sous-ensemble de clients.

Créer une requête

Une requête retourne des données qui satisfont un ensemble de critères.Par exemple, une requête peut retourner une liste des clients qui se trouvent aux États-Unis.Dans cet exemple, les clients sont les données, et situés aux États-Unis est le critère.

[!REMARQUE]

Cette leçon repose sur le projet MyFirstApplication développé dans les leçons Utilisation de données dans LightSwitch (visite guidée) et modifié dans les leçons Création d'écrans.Si vous avez terminé les leçons préalables, ouvrez maintenant le projet ; sinon, terminez les leçons préalables, puis revenez à cette leçon.

Pour créer une requête

Dans l'Explorateur de solutions, double-cliquez sur le nœud OrdersByCustomer.
Dans le volet gauche du Concepteur d'écran, sélectionnez le nœud Customers.
Cliquez sur le lien Modifier la requête.

Le Concepteur de requêtes apparaît.
Dans le Concepteur de requêtes, cliquez sur Ajouter un filtre.

Une condition de filtre est ajoutée à la section Filtrer.Plusieurs listes déroulantes et une zone de texte s'affichent en regard de la condition de filtre.
Dans la première liste déroulante sélectionnez Where.
Dans la deuxième liste déroulante, sélectionnez Pays.
Dans la troisième liste déroulante, sélectionnez = (égal).
Dans la quatrième liste déroulante, sélectionnez Littéral.
Dans la zone de texte, tapez USA.
Cliquez de nouveau sur Ajouter un filtre.
Dans la première liste déroulante, sélectionnez Or.
Dans la deuxième liste déroulante, sélectionnez Pays.
Dans la troisième liste déroulante, sélectionnez = (égal).
Dans la quatrième liste déroulante, sélectionnez Littéral.
Dans cette zone de texte, tapez Canada.

Cela crée une expression de requête qui retournera tous les enregistrements de Customers où la valeur du champ Pays est égale à la valeur littérale « USA » ou à la valeur littérale « Canada ».
Cliquez sur Ajouter un tri.
Dans la première liste déroulante sélectionnez City.

Cela triera la requête par Ville dans l'ordre alphabétique.
Appuyez sur F5 pour exécuter l'application.

Lorsque vous ouvrez l'écran Orders by Customers, notez que seuls les clients des USA ou du Canada sont affichés, et qu'ils sont triés par ville.

Présentation détaillée

Cette leçon a indiqué comment créer une requête qui retourne un sous-ensemble de clients.La section de filtre de la requête a spécifié une condition, et la section de tri a spécifié comment trier les résultats.Traduite en langage naturel, la requête signifie « Donnez-moi une liste de tous les clients aux États-Unis et au Canada, triés par ville ».

Dans la première liste déroulante de filtre, vous pouvez sélectionner Where ou WhereNot.La modification de la clause en WhereNot modifierait la requête pour retourner des clients implantés partout sauf aux États-Unis et au Canada.

La troisième liste déroulante de filtre contient des opérateurs que vous pouvez appliquer à la requête.Par exemple, si vous aviez choisi un champ de type numérique dans la deuxième liste déroulante, vous pourriez sélectionner > (est supérieur à) pour retourner uniquement les enregistrements qui dépassent une valeur spécifiée.

La quatrième liste déroulante de filtre contient trois choix : Littéral, Propriété et Paramètre.Comme cela est indiqué dans cette leçon, Littéral signifie que le critère est une valeur littérale.Si vous aviez choisi Propriété, une liste des champs de l'entité Customers aurait été affichée afin que vous puissiez filtrer les résultats par propriété.Par exemple, vous pourriez retourner tous les clients où le ContactName correspond au CompanyName.L'option Paramètre est décrite dans la leçon Création d'une requête paramétrée.

La section de tri d'une requête détermine l'ordre dans lequel les résultats sont affichés en premier dans un écran de l'application en cours d'exécution.Un utilisateur peut ensuite modifier l'ordre de tri.