Ajout d'une propriété locale

Article
03/04/2013

Dans cette leçon, vous apprendrez comment personnaliser un écran en ajoutant une propriété locale.

Ajout d'une propriété locale

Outre utiliser le Concepteur d'écran pour personnaliser les contrôles sur un écran, vous pouvez également ajouter des éléments de données, par exemple, une propriété locale qui peut afficher une valeur calculée.

Pour ajouter une propriété locale

Dans l'Explorateur de solutions, double-cliquez sur l'écran OrdersByCustomers.
Dans le Ruban Barre d'outils, cliquez sur le bouton Ajouter un élément de données.
Dans la boîte de dialogue Ajouter un élément de données, sélectionnez Propriété locale, puis cliquez sur OK.

Un nouveau nœud nommé Property1 est ajouté dans le volet de gauche du Concepteur d'écran.
Sélectionnez le nœud Property1, puis dans la fenêtre Propriétés, sélectionnez la propriété Name et tapez NumberOfOrders.

Le nom change également dans le volet de gauche du concepteur.
Faites glisser le nœud NumberOfOrders juste en dessous du nœud Barre de commandes sous le nœud Disposition des lignes | Colonne des détails dans le volet central.
Dans la liste déroulante du nœud Nombre de commandes , remplacez le type de contrôle par Label.
Appuyez sur F5 pour exécuter l'application, et dans le menu de navigation, cliquez sur Orders By Customers pour afficher l'écran et vérifier les modifications.

Notez qu'un champ Number of Orders est maintenant affiché en haut de la colonne de droite, et qu'aucune valeur n'est affichée.
Pour fermer la fenêtre, cliquez sur le bouton Fermer dans le coin supérieur droit de la fenêtre d'application.

Pour afficher une valeur pour une propriété locale

Dans le volet de gauche du Concepteur d'écran, sélectionnez le nœud Customers.
Sur le Ruban Barre d'outils, dans la liste Écrire le code, cliquez sur Customers_SelectionChanged.

L'Éditeur de code s'ouvre et affiche la méthode Customers_SelectionChanged.
Dans la méthode Customers_SelectionChanged, ajoutez le code suivant.
```
NumberOfOrders = Orders.Count.ToString
```
```
NumberOfOrders = Orders.Count.ToString();
```
Lorsqu'un client est sélectionné, ce code calcule le nombre de commandes de ce client.La valeur s'affiche ensuite dans le champ Number of Orders.
Appuyez sur F5 pour exécuter l'application, et dans le menu de navigation, cliquez sur Orders By Customers pour afficher l'écran et vérifier les modifications.

Notez que lorsque vous sélectionnez un client, le nombre de commandes pour ce client est affiché dans le champ Number of Orders.
Pour fermer la fenêtre, cliquez sur le bouton Fermer dans le coin supérieur droit de la fenêtre d'application.

Présentation détaillée

Cette leçon a indiqué comment créer une propriété locale pour afficher une valeur calculée dans un écran.Dans ce cas, vous avez utilisé la méthode SelectionChanged de la collection de clients pour retourner le Count de commandes chaque fois qu'un client est sélectionné.Vous avez peut-être noté que le code utilise la méthode ToString pour convertir le Count en String.Cela est obligatoire, car la propriété locale a été définie comme un String dans la boîte de dialogue Ajouter un élément de données.Si vous aviez sélectionné à la place Integer comme type, la conversion ne serait pas obligatoire.

Outre utiliser une propriété locale pour afficher une valeur calculée, vous pouvez également utiliser une propriété locale pour collecter une valeur d'entrée de l'utilisateur.Par exemple, vous pouvez créer une propriété locale qui affiche une liste de villes lorsqu'un utilisateur spécifie une région géographique.