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

项目
09/10/2008

更新：2007 年 11 月

适用对象
本主题中的信息仅适用于指定的 Visual Studio Tools for Office 项目和 Microsoft Office 版本。文档级项目 Excel 2007 Excel 2003 应用程序级项目 Excel 2007 有关更多信息，请参见按应用程序和项目类型提供的功能。

本主题中的信息仅适用于指定的 Visual Studio Tools for Office 项目和 Microsoft Office 版本。

文档级项目

Excel 2007
Excel 2003

应用程序级项目

Excel 2007

有关更多信息，请参见按应用程序和项目类型提供的功能。

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

如果发生错误，您可以编写代码来提供用于更正错误的其他数据。有关更多信息，请参见如何：向 ListObject 控件添加新行时处理错误。

数据验证

只要将行添加到绑定到数据的 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。

请参见

修订记录

日期	修订	原因
2008 年 7 月	修改了示例以便可以在应用程序级外接程序中使用它。	SP1 功能更改。

通过