Partager via

Procédure pas à pas : validation des données dans le contrôle DataGridView Windows Forms

Lorsque vous affichez des fonctionnalités d’entrée de données aux utilisateurs, vous devez fréquemment valider les données entrées dans votre formulaire. La DataGridView classe fournit un moyen pratique d’effectuer la validation avant que les données ne sont validées dans le magasin de données. Vous pouvez valider les données en gérant l’événement CellValidating, qui est déclenché par le DataGridView lorsque la cellule active change.

Dans ce tutoriel, vous allez récupérer des lignes de la table Customers dans la base de données d'exemple Northwind et les afficher dans un contrôle DataGridView. Lorsqu’un utilisateur modifie une cellule dans la CompanyName colonne et tente de quitter la cellule, le CellValidating gestionnaire d’événements examine la nouvelle chaîne de nom de société pour s’assurer qu’elle n’est pas vide ; si la nouvelle valeur est une chaîne vide, le DataGridView curseur de l’utilisateur empêche le curseur de l’utilisateur de quitter la cellule jusqu’à ce qu’une chaîne non vide soit entrée.

Pour copier le code de cette rubrique en tant que liste unique, consultez Comment : valider des données dans le contrôle DataGridView Windows Forms.

Conditions préalables

Pour effectuer cette procédure pas à pas, vous aurez besoin des éléments suivants :

  • Accès à un serveur doté de l’exemple de base de données Northwind SQL Server.

Création du formulaire

Pour valider les données entrées dans un DataGridView

  1. Créez une classe qui dérive de Form et contient un contrôle DataGridView et un composant BindingSource.

    L’exemple de code suivant fournit une initialisation de base et inclut une méthode Main.

    using System;
using System.Data;
using System.Data.SqlClient;
using System.Windows.Forms;

public class Form1 : System.Windows.Forms.Form
{
    private DataGridView dataGridView1 = new DataGridView();
    private BindingSource bindingSource1 = new BindingSource();

    public Form1()
    {
        // Initialize the form.
        this.dataGridView1.Dock = DockStyle.Fill;
        this.Controls.Add(dataGridView1);
        this.Load += new EventHandler(Form1_Load);
        this.Text = "DataGridView validation demo (disallows empty CompanyName)";
    }

    Imports System.Data
Imports System.Data.SqlClient
Imports System.Windows.Forms

Public Class Form1
    Inherits System.Windows.Forms.Form

    Private WithEvents dataGridView1 As New DataGridView()
    Private bindingSource1 As New BindingSource()

    Public Sub New()

        ' Initialize the form.
        Me.dataGridView1.Dock = DockStyle.Fill
        Me.Controls.Add(dataGridView1)
        Me.Text = "DataGridView validation demo (disallows empty CompanyName)"

    End Sub

        [STAThread]
    static void Main()
    {
        Application.EnableVisualStyles();
        Application.Run(new Form1());
    }
}

        <STAThread()> _
    Shared Sub Main()
        Application.EnableVisualStyles()
        Application.Run(New Form1())
    End Sub

End Class

  2. Implémentez une méthode dans la définition de classe de votre formulaire pour gérer les détails de la connexion à la base de données.

    Cet exemple de code utilise une méthode GetData qui retourne un objet DataTable rempli. Veillez à définir la variable connectionString sur une valeur appropriée pour votre base de données.

    Important

    Le stockage d’informations sensibles, telles qu’un mot de passe, dans la chaîne de connexion peut affecter la sécurité de votre application. L’utilisation de l’authentification Windows, également appelée sécurité intégrée, est un moyen plus sécurisé de contrôler l’accès à une base de données. Pour plus d’informations, consultez Protection des informations de connexion.

    private static DataTable GetData(string selectCommand)
{
    string connectionString =
        "Integrated Security=SSPI;Persist Security Info=False;" +
        "Initial Catalog=Northwind;Data Source=localhost;Packet Size=4096";

    // Connect to the database and fill a data table.
    SqlDataAdapter adapter =
        new SqlDataAdapter(selectCommand, connectionString);
    DataTable data = new DataTable();
    data.Locale = System.Globalization.CultureInfo.InvariantCulture;
    adapter.Fill(data);

    return data;
}

    Private Shared Function GetData(ByVal selectCommand As String) As DataTable

    Dim connectionString As String = _
        "Integrated Security=SSPI;Persist Security Info=False;" + _
        "Initial Catalog=Northwind;Data Source=localhost;Packet Size=4096"

    ' Connect to the database and fill a data table.
    Dim adapter As New SqlDataAdapter(selectCommand, connectionString)
    Dim data As New DataTable()
    data.Locale = System.Globalization.CultureInfo.InvariantCulture
    adapter.Fill(data)

    Return data

End Function

  3. Implémentez un gestionnaire pour l’événement Load de votre formulaire qui initialise les DataGridView et BindingSource et configure la liaison de données.

    private void Form1_Load(System.Object sender, System.EventArgs e)
{
    // Attach DataGridView events to the corresponding event handlers.
    this.dataGridView1.CellValidating += new
        DataGridViewCellValidatingEventHandler(dataGridView1_CellValidating);
    this.dataGridView1.CellEndEdit += new
        DataGridViewCellEventHandler(dataGridView1_CellEndEdit);

    // Initialize the BindingSource and bind the DataGridView to it.
    bindingSource1.DataSource = GetData("select * from Customers");
    this.dataGridView1.DataSource = bindingSource1;
    this.dataGridView1.AutoResizeColumns(
        DataGridViewAutoSizeColumnsMode.AllCellsExceptHeader);
}

    Private Sub Form1_Load(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Me.Load

    ' Initialize the BindingSource and bind the DataGridView to it.
    bindingSource1.DataSource = GetData("select * from Customers")
    Me.dataGridView1.DataSource = bindingSource1
    Me.dataGridView1.AutoResizeColumns( _
        DataGridViewAutoSizeColumnsMode.AllCellsExceptHeader)

End Sub

  4. Implémentez des gestionnaires pour les événements DataGridView du contrôle CellValidatingCellEndEdit.

    Le CellValidating gestionnaire d’événements est l’endroit où vous déterminez si la valeur d’une cellule de la CompanyName colonne est vide. Si la validation de la valeur de la cellule échoue, définissez la propriété de la classe Cancel sur System.Windows.Forms.DataGridViewCellValidatingEventArgs. Ainsi, le DataGridView contrôle empêche le curseur de quitter la cellule. Définissez la ErrorText propriété sur la ligne à une chaîne explicite. Cette opération affiche une icône d’erreur avec une info-bulle qui contient le texte d’erreur. Dans le CellEndEdit gestionnaire d’événements, attribuez à la propriété ErrorText de la ligne une chaîne vide. L’événement CellEndEdit se produit uniquement lorsque la cellule quitte le mode d’édition, qu’elle ne peut pas faire en cas d’échec de validation.

    private void dataGridView1_CellValidating(object sender,
    DataGridViewCellValidatingEventArgs e)
{
    string headerText =
        dataGridView1.Columns[e.ColumnIndex].HeaderText;

    // Abort validation if cell is not in the CompanyName column.
    if (!headerText.Equals("CompanyName")) return;

    // Confirm that the cell is not empty.
    if (string.IsNullOrEmpty(e.FormattedValue.ToString()))
    {
        dataGridView1.Rows[e.RowIndex].ErrorText =
            "Company Name must not be empty";
        e.Cancel = true;
    }
}

void dataGridView1_CellEndEdit(object sender, DataGridViewCellEventArgs e)
{
    // Clear the row error in case the user presses ESC.
    dataGridView1.Rows[e.RowIndex].ErrorText = String.Empty;
}

    Private Sub dataGridView1_CellValidating(ByVal sender As Object, _
    ByVal e As DataGridViewCellValidatingEventArgs) _
    Handles dataGridView1.CellValidating

    Dim headerText As String = _
        dataGridView1.Columns(e.ColumnIndex).HeaderText

    ' Abort validation if cell is not in the CompanyName column.
    If Not headerText.Equals("CompanyName") Then Return

    ' Confirm that the cell is not empty.
    If (String.IsNullOrEmpty(e.FormattedValue.ToString())) Then
        dataGridView1.Rows(e.RowIndex).ErrorText = _
            "Company Name must not be empty"
        e.Cancel = True
    End If
End Sub

Private Sub dataGridView1_CellEndEdit(ByVal sender As Object, _
    ByVal e As System.Windows.Forms.DataGridViewCellEventArgs) _
    Handles dataGridView1.CellEndEdit

    ' Clear the row error in case the user presses ESC.   
    dataGridView1.Rows(e.RowIndex).ErrorText = String.Empty

End Sub

Test de l’application

Vous pouvez maintenant tester le formulaire pour vous assurer qu’il se comporte comme prévu.

Pour tester le formulaire

  • Compilez et exécutez l’application.

    Vous verrez un DataGridView rempli de données de la table Customers. Lorsque vous double-cliquez sur une cellule de la CompanyName colonne, vous pouvez modifier la valeur. Si vous supprimez tous les caractères et appuyez sur la touche TAB pour quitter la cellule, DataGridView vous empêche de quitter. Lorsque vous saisissez un texte non vide dans la cellule, le contrôle DataGridView vous permet de quitter la cellule.

Étapes suivantes

Cette application vous donne une compréhension de base des fonctionnalités du contrôle DataGridView. Vous pouvez personnaliser l’apparence et le comportement du contrôle DataGridView de plusieurs façons :

Voir aussi

  • Last updated on