如何：在向 ListObject 控件添加新行时验证数据

项目
08/12/2011

用户可以向绑定到数据的 ListObject 控件中添加新行。此外还可以在向数据源提交更改之前对用户的数据进行验证。

**适用于：**本主题中的信息适用于 Excel 2007 和 Excel 2010 的文档级项目和应用程序级项目。有关更多信息，请参见按 Office 应用程序和项目类型提供的功能。

数据验证

只要将行添加到绑定到数据的 ListObject，就会引发 BeforeAddDataBoundRow 事件。您可以处理此事件来执行数据验证。例如，如果应用程序要求只能将年龄在 18 至 65 岁之间的雇员添加到数据源，则可以在添加行之前对输入的年龄进行验证，以确保其处于上述范围之内。

提示

除客户端外，在服务器上也应始终检查用户输入。有关更多信息，请参见安全客户端应用程序 (ADO.NET)。

向数据绑定的 ListObject 中添加新行时对数据进行验证

在类级别创建 ID 和 DataTable 的变量。

Dim id As Integer = 0
Dim employeeTable As System.Data.DataTable

private int id = 0;
private System.Data.DataTable employeeTable;

创建一个新的 DataTable，然后在 Sheet1 类（在文档级项目中）或 ThisAddIn 类（在应用程序级项目中）的 Startup 事件处理程序中添加示例列和数据。

employeeTable = New System.Data.DataTable("Employees")

Dim column As System.Data.DataColumn = _
    employeeTable.Columns.Add("Id", GetType(Int32))
column.AllowDBNull = False

employeeTable.Columns.Add("FirstName", GetType(String))
employeeTable.Columns.Add("LastName", GetType(String))
employeeTable.Columns.Add("Age", GetType(Int32))

employeeTable.Rows.Add(id, "Nancy", "Anderson", 56)
employeeTable.Rows.Add(id, "Robert", "Brown", 44)
id += 1

list1.SetDataBinding(employeeTable, "", "FirstName", "LastName", "Age")

employeeTable = new System.Data.DataTable("Employees");

System.Data.DataColumn column = employeeTable.Columns.Add
    ("Id", typeof(int));
column.AllowDBNull = false;

employeeTable.Columns.Add("FirstName", typeof(string));
employeeTable.Columns.Add("LastName", typeof(string));
employeeTable.Columns.Add("Age", typeof(int));

employeeTable.Rows.Add(id, "Nancy", "Anderson", "56");
employeeTable.Rows.Add(id, "Robert", "Brown", "44");
id++;

list1.SetDataBinding(employeeTable, "", "FirstName", "LastName", "Age");

list1.BeforeAddDataBoundRow +=new Microsoft.Office.Tools.Excel.
    BeforeAddDataBoundRowEventHandler(list1_BeforeAddDataBoundRow);

向 list1_BeforeAddDataBoundRow 事件处理程序中添加代码，以检查输入的年龄是否处于可接受的范围之内。

Private Sub list1_BeforeAddDataBoundRow(ByVal sender As Object, ByVal e As  _
    Microsoft.Office.Tools.Excel.BeforeAddDataBoundRowEventArgs) _
    Handles list1.BeforeAddDataBoundRow

    Dim row As System.Data.DataRow = (CType(e.Item, System.Data.DataRowView)).Row

    If Not row("Age") Is Nothing And Not row("Age") Is Convert.DBNull Then

        Dim ageEntered As Integer = CType(row("Age"), Int32)

        If ageEntered < 21 Or ageEntered > 65 Then
            System.Windows.Forms.MessageBox.Show _
                ("Age must be between 21 and 65. The row cannot be added.")
            e.Cancel = True
            Return
        End If

        row("ID") = id
        id += 1

    Else
        System.Windows.Forms.MessageBox.Show("You must enter an age.")
        e.Cancel = True
    End If
End Sub

private void list1_BeforeAddDataBoundRow(object sender,
    Microsoft.Office.Tools.Excel.BeforeAddDataBoundRowEventArgs e)
{
    System.Data.DataRow row = ((System.Data.DataRowView)e.Item).Row;

    if (row["Age"] != null && row["Age"] != Convert.DBNull)
    {
        int ageEntered = (int)row["Age"];

        if (ageEntered < 21 || ageEntered > 65)
        {
            System.Windows.Forms.MessageBox.Show
                ("Age must be between 21 and 65. The row cannot be added.");
            e.Cancel = true;
            return;
        }
        row["ID"] = id;
        id++;
    }
    else
    {
        System.Windows.Forms.MessageBox.Show("You must enter an age.");
        e.Cancel = true;
    }
}

编译代码

此代码示例假定在显示此代码的工作表中有一个名为 list1 的现有 ListObject。

请参见

通过

如何：在向 ListObject 控件添加新行时验证数据

数据验证

向数据绑定的 ListObject 中添加新行时对数据进行验证

编译代码

请参见

任务

概念

其他资源

其他资源