ListObject.SetDataBinding – metoda (Object)

Článek
01/03/2014

Váže ListObject ovládací prvek zdroje dat.

Obor názvů: Microsoft.Office.Tools.Excel
Sestavení: Microsoft.Office.Tools.Excel (v Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Deklarace
Sub SetDataBinding ( _
    dataSource As Object _
)

void SetDataBinding(
    Object dataSource
)

Parametry

dataSource
Typ: System.Object
Objekt, který chcete použít jako zdroj dat pro ListObject ovládacího prvku.

Výjimky

Výjimka	Podmínka
SetDataBindingFailedException	Nelze vytvořit vazbu na zdroj zadaná data.
ArgumentException	Argument je neplatný.
ArgumentNullException	The dataSource argument is nullodkaz null (Nothing v jazyce Visual Basic).

Poznámky

Zdrojem dat může být libovolný objekt, který implementuje IList, IListSource, IBindingList, nebo IEnumerable, jako DataTable nebo jednorozměrné pole.

Příklady

Následující příklad kódu ukazuje, jak použít SetDataBinding metoda vytvořit vazbu ListObject k DataTable.DataTable Obsahuje dva sloupce, které obsahují jména a stáří zaměstnanců, a čtyři řádky, které představují položky zaměstnance.

Tento příklad je pro vlastní úpravy úrovni dokumentu.

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

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

ListObject Rozhraní

SetDataBinding – přetížení

Microsoft.Office.Tools.Excel – obor názvů

Sdílet prostřednictvím