Comment : ajouter une propriété locale à un écran Silverlight

Vous pouvez ajouter un champ appelé propriété locale à un écran.Vous pouvez utiliser une propriété locale pour collecter une valeur d'entrée ou afficher une valeur calculée.

Pour créer une propriété locale

Du haut du Concepteur d'écran, cliquez sur 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, sélectionnez Propriété locale.
Dans la liste déroulante Type, sélectionnez un type pour la propriété locale.

Vous pouvez sélectionner chacun des types standard, tels que Chaîne, Entier, Adresse de messagerie, ou l'une des entités associées à votre application, telles que Customer, Order Detail ou Product.
Sélectionnez Est obligatoire si vous voulez exiger que ce champ contienne une valeur.

[!REMARQUE]

Si ce champ ne contient pas de valeur lorsque l'utilisateur tente d'ouvrir l'écran, un message de validation s'affiche.
Dans la zone de texte Nom, tapez un nom, puis cliquez sur OK.

La boîte de dialogue Ajouter un élément de données se ferme.La propriété locale s'affiche dans la Liste des membres de l'écran.

Pour ajouter une propriété locale à un écran

Dans la Liste des membres de l'écran, faites glisser la propriété locale sur l'emplacement souhaité de l' Arborescence de contenu de l'écran.
Dans l' Arborescence de contenu de l'écran, dans la liste déroulante qui s'affiche en regard de propriété locale, sélectionnez le type d'affichage souhaité.

Par exemple, si vous créez une propriété locale pour afficher une valeur monétaire, vous pouvez modifier son type d'affichage en Éditeur de monnaies ou Visionneuse de devise.De la même façon, vous pouvez afficher une propriété locale de chaîne sous la forme d'une Zone de texte ou d'une Étiquette.

Pour appliquer des règles de validation à une propriété locale

Dans la Liste des membres de l'écran, sélectionnez la propriété locale.
Dans la fenêtre Propriétés, développez le nœud Validation s'il n'est pas déjà développé.

Les règles de validation disponibles varient selon le type de la propriété locale.
Si la propriété locale doit avoir une valeur, sélectionnez Est obligatoire.

Sélectionnez les autres règles de validation que vous voulez appliquer à la propriété locale.
Si vous devez exécuter une validation plus complexe, cliquez sur Validation personnalisée.

L'éditeur de code s'ouvre.LightSwitch génère une méthode nommée localPropertyName_Validate.Vous pouvez ajouter la logique de validation personnalisée à cette méthode.L'exemple suivant affiche un message d'erreur si l'utilisateur entre moins de trois caractères pour une propriété locale nommée CityCode.
```
Private Sub CityCode_Validate(results As ScreenValidationResultsBuilder)
    If Me.CityCode.Length < 3 Then
        results.AddPropertyError("This string must have at least 3 letters.")
    End If
End Sub
```
```
partial void CityCode_Validate
    (ScreenValidationResultsBuilder results)
{
    if (this.CityCode.Length < 3)
    {
        results.AddPropertyError("This string must have at least 3 letters.");
    }

}
```
Si la chaîne ne contient pas au moins trois caractères, la propriété est présentée en rouge et le message d'erreur tapé ci-dessus s'affiche.

Pour assigner une valeur à une propriété locale à l'aide de code

Vous pouvez affecter une valeur à une propriété locale à l'aide de code.

L'exemple suivant affecte à une propriété locale nommée ApprovedCheckBox la valeur False.

Private Sub OrdersListDetail_InitializeDataWorkspace _
    (saveChangesTo As System.Collections.Generic.List _
     (Of Microsoft.LightSwitch.IDataService))
    ApproveCheckBox = False

End Sub

partial void ApprovedCheckBox_Validate
    (ScreenValidationResultsBuilder results)
{
    ApprovedCheckBox = false;

}

Voir aussi

Tâches

Comment : ajouter une commande personnalisée à un écran Silverlight

Comment : Concevoir un écran Silverlight à l'aide du concepteur d'écran

Autres ressources

Écrans : l'interface utilisateur de votre application

Last updated on 2013-03-04