Ajout d'une validation

Article
03/04/2013

Cette leçon montre comment valider les données qu'un utilisateur entre dans une application LightSwitch.

Validation d'ajout de données

Dans la plupart des applications qui impliquent l'entrée de données, les données doivent être validées avant qu'elles ne soient enregistrées.Par exemple, vous pouvez vérifier qu'un numéro de téléphone contient le nombre correct de chiffres ou qu'un champ obligatoire n'est pas vide.

Le concepteur de données contient un exemple d'un type de validation: chaque champ d'entité a une case à cocher Requis.Si un champ est marqué comme obligatoire et que ce champ est vide, LightSwitch affiche automatiquement un avertissement lorsque l'utilisateur tente d'enregistrer les données.

Vous pouvez également gérer la validation dans LightSwitch en définissant des propriétés de validation ou en écrivant un code de validation personnalisé.

Pour définir des propriétés de validation

Dans l'explorateur de solutions, double-cliquez sur Contacts.
Dans le Concepteur de données, cliquez sur <Ajouter une propriété>, puis tapez ContactState.
Assurez-vous que le type est String.
Dans la fenêtre Propriétés, sélectionnez la propriété Longueur maximale et tapez 2.

Ce paramètre garantit que deux caractères au plus peuvent être tapés dans le champ ContactState.

Pour ajouter du code de validation personnalisé

Dans l'explorateur de solutions, double-cliquez sur Orders_Details.
Dans le Concepteur de données, sélectionnez le champ Quantity.
Dans la fenêtre Propriétés, cliquez sur le lien Validation personnalisée.

L'editeur de code s'ouvre et un bloc de code s'affiche pour la méthode Quantity_Validate.
Ajoutez le code suivant à la méthode Quantity_Validate immédiatement sous la ligne de commentaire.

Attention

Ajoutez du code Visual Basic ou C#, selon le langage de programmation choisi quand le projet a été créé.
```
If Quantity < 1 Then
    results.AddPropertyError("Quantity must be greater than zero.")
End If
```
```
if (Quantity < 1) 
{
    results.AddPropertyError("Quantity must be greater than zero.");
}
```
Ce code garantit qu'une valeur inférieure à un dans le champ Quantité ne peut être enregistrée.Si un utilisateur tente d'enregistrer une valeur inférieure à un, une erreur de validation est déclenchée.

Attention
Ajoutez du code Visual Basic ou C#, selon le langage de programmation choisi quand le projet a été créé.

Présentation détaillée

Cette leçon vous a montré comment valider des données en définissant des propriétés de validation ou en écrivant du code de validation.Des propriétés de validation différentes sont disponibles pour les types de données différents.Par exemple, un type String a une propriété Longueur maximale, et un Integer a des propriétés Valeur minimale et Valeur maximale.Tous les types ont une propriété Est obligatoire, qui est la propriété utilisée pour la case à cocher Requis dans le concepteur de données.

Si vous passez en revue l'entité Customers, notez que les propriétés de validation s'affichent estompées et ne peuvent pas être modifiées.Certains champs, tels que Adresse ont déjà une valeur dans la propriété Longueur maximale.Vous ne pouvez pas définir de propriétés de validation dans une entité d'une source de données attachée; vous ne pouvez les définir que dans les entités que vous créez.

Si vous voulez ajouter la validation pour une entité d'une source de données attachée, vous pouvez le faire en écrivant votre propre code de validation.Vous ne pouvez pas substituer de propriétés de validation existantes, sauf si vous ajoutez une validation plus restrictive.Par exemple, pour un champ qui a une Longueur maximale de 30, vous ne pouvez pas ajouter de code de validation pour affecter à la longueur la valeur 40.Toutefois, vous pouvez ajouter du code pour limiter la longueur à une valeur inférieure à 30.