Procédure pas à pas : ajout d'une validation à un groupe de données

Article
08/10/2011

Cette procédure pas à pas montre comment valider des données lorsque des modifications y sont apportées dans un groupe de données. L'emplacement auquel vous exécutez des contrôles de validation sur vos données dépend des exigences de votre application ; dans le cadre de cette procédure pas à pas, nous validons les données lors de la modification de valeurs contenues dans des colonnes individuelles. Cette procédure pas à pas utilise l'événement ColumnChanging pour vérifier qu'une valeur acceptable est entrée dans l'enregistrement. Si la valeur n'est pas valide, un contrôle ErrorProvider est affiché pour l'utilisateur.

Cet exemple indique également comment utiliser le Concepteur de DataSet afin de créer une classe partielle pour le groupe de données. La classe partielle correspond à l'emplacement dans lequel les utilisateurs peuvent ajouter du code pour étendre les fonctionnalités du groupe de données généré par Visual Studio. Elle n'est pas remplacée en cas de régénération du groupe de données.

Notes

Les boîtes de dialogue et les commandes de menu qui s'affichent peuvent être différentes de celles qui sont décrites dans l'aide, en fonction de vos paramètres actifs ou de l'édition utilisée. Pour modifier vos paramètres, choisissez Importation et exportation de paramètres dans le menu Outils. Pour plus d'informations, consultez Utilisation des paramètres.

Cette procédure pas à pas illustre les tâches suivantes :

Création d'un nouveau projet Application Windows.
Création et configuration d'un groupe de données avec l'Configuration de source de données (Assistant).
Sélection du contrôle à créer sur le formulaire lors du déplacement d'éléments à partir de la fenêtre Sources de données. Pour plus d'informations, consultez Comment : définir le contrôle à créer lors d'une opération de glisser-déplacer à partir de la fenêtre Sources de données.
Création d'un contrôle lié aux données en faisant glisser les éléments depuis la Sources de données (fenêtre) jusqu'à votre formulaire.
Création d'une classe partielle pour étendre les fonctionnalités du groupe de données.
Création d'un gestionnaire d'événements pour l'événement ColumnChanging de la table OrderDetails.
Ajout de la validation pour vérifier que la colonne Quantity contient des valeurs supérieures à 0.
Affichage d'un ErrorProvider, composant (Windows Forms) pour informer les utilisateurs qu'un contrôle lié aux données contient des valeurs non valides.

Composants requis

Pour exécuter cette procédure pas à pas, vous devez :

avoir accès à l'exemple de base de données Northwind. Pour plus d'informations, consultez Comment : installer des exemples de bases de données.

Création d'une nouvelle application Windows

Pour créer le nouveau projet Application Windows

Dans le menu Fichier, créez un nouveau projet.
Nommez le projet ValidationWalkthrough.
Sélectionnez Application Windows, puis cliquez sur OK. Pour plus d'informations, consultez Création d'applications Windows.

Le projet ValidationWalkthrough est créé et ajouté à l'Explorateur de solutions.

Création d'une nouvelle source de données à partir de votre base de données

Pour créer la source de données

Dans le menu Données, cliquez sur Afficher les sources de données.
Dans la fenêtre Sources de données, sélectionnez Ajouter une nouvelle source de données pour démarrer l'Assistant Configuration de source de données.
Sélectionnez Base de données dans la page Choisir un type de source de données, puis cliquez sur Suivant.
Dans la page Choisir votre connexion de données, effectuez l'une des opérations suivantes :
- Si une connexion de données à l'exemple de base de données Northwind est disponible dans la liste déroulante, sélectionnez-la.
  
  ou
- Sélectionnez Nouvelle connexion pour afficher la boîte de dialogue Ajouter/Modifier la connexion. Pour plus d'informations, consultez Ajouter/Modifier une connexion, boîte de dialogue (Général).
Si votre base de données requiert un mot de passe, sélectionnez l'option pour inclure les données sensibles, puis cliquez sur Suivant.
Cliquez sur Suivant dans la page Enregistrer la chaîne de connexion dans le fichier de configuration de l'application.
Développez le nœud Tables dans la page Choisir vos objets de base de données.
Sélectionnez la table Order Details, puis cliquez sur Terminer.

NorthwindDataSet est ajouté à votre projet et la table OrderDetails apparaît dans la fenêtre Sources de données.

Création de contrôles liés aux données

Pour créer des contrôles liés aux données sur le formulaire

Dans la fenêtre Sources de données, sélectionnez la table Order Details.
Choisissez Détails dans la liste de contrôles de la table.
Faites glisser le nœud Order Details depuis la fenêtre Sources de données jusqu'à Form1.

Les contrôles liés aux données avec des étiquettes descriptives s'affichent sur le formulaire, ainsi qu'une barre d'outils (BindingNavigator) pour naviguer au sein des enregistrements. Les contrôles liés aux données avec des étiquettes descriptives s'affichent sur le formulaire, ainsi qu'une barre d'outils (BindingNavigator) pour naviguer au sein des enregistrements. NorthwindDataSet, Order_DetailsTableAdapter, BindingSource et BindingNavigator s'affichent dans la barre d'état des composants.

Ajout d'un contrôle ErrorProvider au formulaire

Pour configurer un contrôle ErrorProvider

Faites glisser un contrôle ErrorProvider depuis la Boîte à outils jusqu'à Form1.
Dans la fenêtre Propriétés, affectez à la propriété DataSource de ErrorProvider la valeur Order_DetailsBindingSource.

Notes

Ne définissez pas la propriété DataMember.

Création du gestionnaire d'événements ColumnChanging

Pour créer les gestionnaires d'événements de validation

Ouvrez NorthwindDataSet dans le Concepteur de DataSet en double-cliquant sur le fichier NorthwindDataSet.xsd dans l'Explorateur de solutions.
Double-cliquez sur la colonne Quantity dans la table OrderDetails pour créer le gestionnaire d'événements OrderDetailsDataTable_ColumnChanging. (En C#, seule la classe partielle de la table de données est créée.)

Notes

Si vous double-cliquez sur le nom de la table (Order Details dans la barre de titre), un gestionnaire d'événements est créé pour l'événement RowChanging.

Ajoutez du code pour vérifier qu'e.ProposedValue contient des valeurs supérieures à 0. Si la valeur proposée est inférieure ou égale à 0, définissez la colonne de façon à indiquer qu'elle contient une erreur.

Collez le code suivant dans le gestionnaire d'événements de modification de colonne, sous le commentaire Ajoutez le code utilisateur ici :

If CType(e.ProposedValue, Short) <= 0 Then
        e.Row.SetColumnError(e.Column, "Quantity must be greater than 0")
    Else
        e.Row.SetColumnError(e.Column, "")
End If

// C#
// Add the following code 
// to the partial class.
    public override void EndInit()
    {
        base.EndInit();
        Order_DetailsRowChanging += TestRowChangeEvent;
    }

    public void TestRowChangeEvent(object sender, Order_DetailsRowChangeEvent e)
    {
        if ((short)e.Row.Quantity <= 0)
        {
            e.Row.SetColumnError("Quantity", "Quantity must be greater than 0");
        }
        else
        {
            e.Row.SetColumnError("Quantity", "");
        }
    }

Test de l'application

Pour tester l'application

Appuyez sur F5 pour exécuter l'application.
Remplacez la valeur de la zone de texte Quantité par 0.
Appuyez sur TABULATION pour déplacer le focus hors de la zone de texte.

L'icône du fournisseur d'erreur apparaît.
Posez le pointeur de votre souris au-dessus du fournisseur d'erreur pour afficher le message.

Étapes suivantes

Selon les spécifications de votre application, il se peut que vous deviez effectuer différentes opérations après l'ajout de la validation. Vous pouvez apporter à cette procédure pas à pas les améliorations suivantes :

Ajouter la fonctionnalité permettant de renvoyer les mises à jour à la base de données. Pour plus d'informations, consultez Procédure pas à pas : enregistrement de données dans une base de données (table unique).
Modification du groupe de données pour ajouter ou supprimer des objets de base de données. Pour plus d'informations, consultez Comment : modifier un groupe de données.