Ajout de propriétés calculées
Cette leçon indique comment ajouter une propriété calculée à une entité de données dans une application LightSwitch.
ajouter une propriété calculée
La plupart des données d'une application d'entreprise sont stockées dans une base de données ou une autre source de données, mais vous pouvez fournir des données supplémentaires aux utilisateurs.L'un des moyens pour y parvenir consiste à utiliser une propriété calculée, qui fournit des données basées sur un calcul.Les données peuvent être affichées dans un écran mais elles ne sont pas stockées dans la base de données.
Un total de commande est un exemple d'une propriété calculée pour laquelle vous écrivez du code pour ajouter les montants ligne-article, les taxes et les frais d'expédition.
Pour ajouter une propriété calculée
Dans l' Explorateur de solutions, double-cliquez sur Orders.
Dans le Concepteur de données, cliquez sur <Ajouter une propriété>, puis tapez OrderTotal.
Dans la colonne Type, sélectionnez Money.
Notez que dans la fenêtre Propriétés, la propriété IsComputed est sélectionnée.
Dans la fenêtre Propriétés, cliquez sur le lien Modifier la méthode.
L' Éditeur de code s'ouvre et affiche la méthode OrderTotal_Compute.
Dans la méthode OrderTotal_Compute, ajoutez le code suivant.
For Each Order_Detail In Order_Details result = result + (Order_Detail.UnitPrice * Order_Detail.Quantity) Next result = result + Freight
foreach (Order_Detail od in Order_Details) { result = result += (od.UnitPrice * od.Quantity); } result = result + Freight.Value;
Lorsqu'une commande s'affiche dans un écran, ce code s'exécute et calcule le total de la commande.
Présentation détaillée
Cette leçon a montré comment ajouter une propriété calculée à une entité pour calculer une valeur.Vous avez peut-être noté que lorsque vous avez ajouté le champ OrderTotal à l'entité Orders, le champ a été marqué comme Requis.Dans la fenêtre Propriétés, l'option IsComputed a également été sélectionnée automatiquement.Les champs calculés pour les entités d'une source de données attachée sont toujours à la fois obligatoires et calculés.
L'exemple de code utilise une construction For… Each pour parcourir l'entité Order_Detail.Pour chaque élément de la ligne, le code multiplie le champ UnitPrice par le champ Quantity et stocke le total cumulé dans la variable de résultat.La dernière ligne de code ajoute la valeur du champ Freight au total cumulé.Vous pouvez améliorer ce code pour vérifier si le champ Freight a une valeur.Tel qu'écrit actuellement, si le champ Freight est vide il peut provoquer une exception.
Les propriétés calculées n'ont pas à impliquer des calculs mathématiques.Vous pouvez également utiliser une propriété calculée pour concaténer deux chaînes.Par exemple, si votre entité a un champ FirstName et un champ LastName, vous pouvez créer un champ FullName pour afficher le prénom et le nom ensemble.Dans ce cas, le code de la méthode FullName_Compute ressemblerait à l'exemple suivant.
result = FirstName & " " & LastName
result = FirstName + " " + LastName
Pour un FirstName « Howard » et un LastName « Snyder », le FullName sera affiché dans un écran en tant que « Howard Snyder ».
Vous pouvez également créer une propriété calculée qui utilise les valeurs d'autres propriétés calculées.Par exemple, vous pouvez ajouter une propriété Tax à l'entité Orders, puis écrire le code pour calculer la taxe selon un pourcentage de la propriété OrderTotal calculée.
Les propriétés calculées ont également des limitations.Elles ne peuvent pas être utilisées dans une requête, et les utilisateurs finaux ne peuvent pas trier ou rechercher une colonne calculée.
Étapes suivantes
Dans la leçon suivante, vous apprendrez comment créer des relations entre des entités de données.
Prochaine leçon : Définition des relations
Voir aussi
Tâches
Comment : Ajouter un champ calculé