Comment : valider les données au cours des modifications de colonnes

Article
08/21/2008

Mise à jour : novembre 2007

La validation des données est le processus de vérification des valeurs entrées dans les données de votre application. Il peut être utile de vérifier ces valeurs avant d'envoyer des mises à jour au magasin de données sous-jacent afin de réduire le nombre potentiel d'allers-retours entre une application et le magasin de données.

Remarque :
Le Concepteur de DataSet crée une classe partielle où la logique de validation peut être ajoutée à un groupe de données. Le groupe de données généré par le concepteur ne supprime ou ne modifie aucun code dans la classe partielle. Pour plus d'informations, consultez Comment : étendre les fonctionnalités d'un groupe de données.

Vous pouvez valider des données lorsque la valeur contenue dans une colonne de données change en réponse à l'événement ColumnChanging. Lorsqu'il est déclenché, cet événement passe un argument d'événement (ProposedValue) qui contient la valeur proposée pour la colonne actuelle. Selon le contenu de e.ProposedValue, vous pouvez :

Accepter la valeur proposée en n'effectuant aucune opération.
Refuser la valeur proposée en définissant l'erreur de colonne (SetColumnError) à partir du gestionnaire d'événements de modification de colonne.
Vous pouvez éventuellement utiliser un contrôle ErrorProvider pour afficher un message d'erreur à l'attention de l'utilisateur. Pour plus d'informations, consultez ErrorProvider, composant (Windows Forms).

La validation peut également être effectuée pendant l'événement RowChanging. Pour plus d'informations, consultez Comment : valider les données au cours des modifications de lignes.

Pour valider les données au fur et à mesure que les valeurs des colonnes changent

Ouvrez votre groupe de données dans le Concepteur de DataSet. Pour plus d'informations, consultez Comment : ouvrir un groupe de données dans le Concepteur de DataSet.

Double-cliquez sur la colonne modèle à valider. Cette action entraîne la création du gestionnaire d'événements ColumnChanging du DataTable.

Remarque :
Le Concepteur de DataSet ne crée pas automatiquement de gestionnaire d'événements pour l'événement C#. Le code nécessaire au traitement de l'événement est inclus ci-dessous.

Ajoutez le code permettant de vérifier que ce e.ProposedValue contient des données répondant aux exigences de votre application. Si la valeur proposée est inacceptable, définissez la colonne afin d'indiquer qu'elle contient une erreur.

L'exemple de code suivant définit une erreur de colonne lorsque la colonne Quantity a une valeur inférieure ou égale à 0. Le gestionnaire d'événements de modification de colonne doit se présenter sous la forme suivante :

'Visual Basic
Private Sub Order_DetailsDataTable_ColumnChanging(ByVal sender As System.Object, ByVal e As System.Data.DataColumnChangeEventArgs) _
    Handles Me.ColumnChanging

    If (e.Column.ColumnName = Me.QuantityColumn.ColumnName) Then

        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
    End If
End Sub

// C#
// Add this code to the DataTable 
// partial class.
    public override void EndInit()
    {
        base.EndInit();
        ColumnChanging += SampleColumnChangingEvent;
    }

    public void SampleColumnChangingEvent(object sender, System.Data.DataColumnChangeEventArgs e)
    {
        if (e.Column.ColumnName == QuantityColumn.ColumnName)
        {
            if ((short)e.ProposedValue <= 0)
            {
                e.Row.SetColumnError("Quantity", "Quantity must be greater than 0");
            }
            else
            {
                e.Row.SetColumnError("Quantity", "");
            }
        }
    }

Voir aussi

Comment : valider les données au cours des modifications de colonnes

Pour valider les données au fur et à mesure que les valeurs des colonnes changent

Voir aussi

Tâches

Concepts

Référence

Autres ressources

Ressources supplémentaires