ListObject.SetDataBinding 方法 (Object)

發行項
08/12/2011

將 ListObject 控制項繫結至資料來源。

命名空間： Microsoft.Office.Tools.Excel
組件： Microsoft.Office.Tools.Excel (在 Microsoft.Office.Tools.Excel.dll 中)

語法

'宣告
Sub SetDataBinding ( _
    dataSource As Object _
)

void SetDataBinding(
    Object dataSource
)

參數

dataSource
型別：System.Object
做為 ListObject 控制項資料來源的物件。

例外狀況

例外狀況	條件
SetDataBindingFailedException	無法繫結至指定的資料來源。
ArgumentException	引數無效。
ArgumentNullException	dataSource 引數為 nullNull 參照 (即 Visual Basic 中的 Nothing)。

備註

資料來源可以是實作 IList、IListSource、IBindingList 或 IEnumerable 的任何物件，例如 DataTable 或一維陣列。

範例

下列程式碼範例會示範如何使用 SetDataBinding 方法，將 ListObject 繫結至 DataTable。 DataTable 包含兩個欄 (員工的姓名和年齡) 以及表示員工資料的四個列。

這是示範文件層級自訂的範例。

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