ListObject.SetDataBinding 方法 (Object)

ListObject 控件绑定到数据源。

命名空间:  Microsoft.Office.Tools.Excel
程序集:  Microsoft.Office.Tools.Excel(在 Microsoft.Office.Tools.Excel.dll 中)

语法

声明
Sub SetDataBinding ( _
    dataSource As Object _
)
void SetDataBinding(
    Object dataSource
)

参数

异常

异常 条件
SetDataBindingFailedException

未能绑定到指定的数据源。

ArgumentException

该参数无效。

ArgumentNullException

dataSource 参数为 nullnull 引用(在 Visual Basic 中为 Nothing)。

备注

数据源可以是实现 IListIListSourceIBindingListIEnumerable 的任何对象,如 DataTable 或一维数组。

示例

下面的代码示例阐释如何使用 SetDataBinding 方法将 ListObject 绑定到 DataTableDataTable 包含两个包含雇员姓名和年龄的列,以及四个表示雇员项的行。

此示例针对的是文档级自定义项。

    Private Sub ListObject_SetDataBinding()
        Dim Ages As Integer() = {32, 44, 28, 61}
        Dim Names As String() = {"Reggie", "Sally", _
            "Henry", "Christine"}

        ' Create a data table with two columns.
        Dim table = New DataTable()
        Dim column1 As New DataColumn("Names", GetType(String))
        Dim column2 As New DataColumn("Ages", GetType(Integer))
        table.Columns.Add(column1)
        table.Columns.Add(column2)

        ' Add the four rows of data to the table.
        Dim row As DataRow
        Dim i As Integer
        For i = 0 To 3
            row = table.NewRow()
            row("Names") = Names(i)
            row("Ages") = Ages(i)
            table.Rows.Add(row)
        Next i

        Dim List1 As Microsoft.Office.Tools.Excel.ListObject = _
            Me.Controls.AddListObject(Me.Range("A1", "B4"), "List1")

        ' Bind the list object to the table.
        List1.SetDataBinding(table)

    End Sub

private void ListObject_SetDataBinding()
{
    int[] Ages = { 32, 44, 28, 61 };
    string[] Names = { "Reggie", "Sally", "Henry", "Christine" };

    // Create a data table with two columns.
    System.Data.DataTable table = new DataTable();
    DataColumn column1 = new DataColumn("Names", typeof(string));
    DataColumn column2 = new DataColumn("Ages", typeof(int));
    table.Columns.Add(column1);
    table.Columns.Add(column2);

    // Add the four rows of data to the table.
    DataRow row;
    for (int i = 0; i < 4; i++)
    {
        row = table.NewRow();
        row["Names"] = Names[i];
        row["Ages"] = Ages[i];
        table.Rows.Add(row);
    }

    Microsoft.Office.Tools.Excel.ListObject list1 =
        this.Controls.AddListObject(this.Range["A1", "B4"], "list1");

    // Bind the list object to the table.
    list1.SetDataBinding(table);
}

.NET Framework 安全性

请参见

参考

ListObject 接口

SetDataBinding 重载

Microsoft.Office.Tools.Excel 命名空间