演练：验证 Windows 窗体 DataGridView 控件中的数据

项目
08/18/2008

更新：2007 年 11 月

向用户显示数据输入功能时，必须频繁验证输入窗体中的数据。DataGridView 类提供了在将数据提交到数据存储区之前执行验证的便利方式。可以通过处理 CellValidating 事件来验证数据，该事件是在当前单元格发生更改时由 DataGridView 引发的。

在本演练中，将从 Northwind 示例数据库的 Customers 表中检索行，并将检索到的行显示在 DataGridView 控件中。当用户编辑 CompanyName 列中的单元格后试图离开该单元格时，CellValidating 事件处理程序将检查新的公司名称字符串，以确保它不为空；如果新的值是空字符串，则 DataGridView 阻止用户的光标离开该单元格，直到用户输入非空的字符串。

若要以单个列表的形式复制本主题中的代码，请参见如何：验证 Windows 窗体 DataGridView 控件中的数据。

先决条件

若要完成本演练，您需要：

对 Northwind SQL Server 示例数据库所在的服务器的访问权限。

创建窗体

验证在 DataGridView 中输入的数据

创建一个从 Form 派生的类，该类包含一个 DataGridView 控件和一个 BindingSource 组件。

下面的代码示例提供了基本的初始化功能，并包含一个 Main 方法。

Imports System
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()> _
    Shared Sub Main()
        Application.EnableVisualStyles()
        Application.Run(New Form1())
    End Sub

End Class

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)";
    }


...


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

}

在窗体的类定义中实现一个方法，用于处理有关与数据库的连接的详细信息。

此代码示例使用 GetData 方法，该方法返回填充的 DataTable 对象。请确保将 connectionString 变量设置为适用于您的数据库的值。

安全说明：
将敏感信息（如密码）存储在连接字符串中可能会影响应用程序的安全性。若要控制对数据库的访问，一种较为安全的方法是使用 Windows 身份验证（也称为集成安全性）。有关更多信息，请参见保护连接信息 (ADO.NET)。

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

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;
}

为窗体的 Load 事件实现一个处理程序，该事件初始化 DataGridView 和 BindingSource 并设置数据绑定。

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

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);
}

实现 DataGridView 控件的 CellValidating 和 CellEndEdit 事件的处理程序。

可以在 CellValidating 事件处理程序中确定 CompanyName 列中的单元格的值是否为空。如果单元格值验证失败，请将 System.Windows.Forms.DataGridViewCellValidatingEventArgs 类的 Cancel 属性设置为 true。这将导致 DataGridView 控件阻止光标离开该单元格。将该行的 ErrorText 属性设置为解释性字符串。这将显示错误图标，其工具提示将包含此错误文本。在 CellEndEdit 事件处理程序中，将该行的 ErrorText 属性设置为空字符串。只有当单元格退出编辑模式（如果验证失败，则不能退出单元格）时，才能发生 CellEndEdit 事件。

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

    ' Validate the CompanyName entry by disallowing empty strings.
    If dataGridView1.Columns(e.ColumnIndex).Name = "CompanyName" Then
        If e.FormattedValue IsNot Nothing AndAlso _
            String.IsNullOrEmpty(e.FormattedValue.ToString()) Then

            dataGridView1.Rows(e.RowIndex).ErrorText = _
                "Company Name must not be empty"
            e.Cancel = True

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

private void dataGridView1_CellValidating(object sender,
    DataGridViewCellValidatingEventArgs e)
{
    // Validate the CompanyName entry by disallowing empty strings.
    if (dataGridView1.Columns[e.ColumnIndex].Name == "CompanyName")
    {
        if (e.FormattedValue == null && 
            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;
}

测试应用程序

现在可以测试窗体，以确保它的行为与预期相同。

测试窗体

编译并运行应用程序。

您将看到一个用 Customers 表的数据填充的 DataGridView。双击 CompanyName 列中的单元格时，可以编辑该值。如果删除所有字符，并按 Tab 键退出该单元格，则 DataGridView 会阻止您退出。在该单元格中键入非空字符串后，DataGridView 控件将允许您退出此单元格。

后续步骤

此应用程序使您对 DataGridView 控件的功能有一个基本了解。您可以通过以下几种方法来自定义 DataGridView 控件的外观和行为：

更改边框和标题样式。有关更多信息，请参见如何：更改 Windows 窗体 DataGridView 控件中的边框和网格线的样式。
允许或限制用户向 DataGridView 控件中输入数据。有关更多信息，请参见如何：防止在 Windows 窗体 DataGridView 控件中添加和删除行和如何：使 Windows 窗体 DataGridView 控件中的列只读。
检查用户输入中是否有与数据库有关的错误。有关更多信息，请参见演练：处理在 Windows 窗体 DataGridView 控件中输入数据时发生的错误。
使用虚拟模式处理特大数据集。有关更多信息，请参见演练：在 Windows 窗体 DataGridView 控件中实现虚拟模式。
自定义单元格的外观。有关更多信息，请参见如何：自定义 Windows 窗体 DataGridView 控件中单元格的外观和如何：设置 Windows 窗体 DataGridView 控件中的字体和颜色样式。

请参见

通过