ListObject.SetDataBinding – metoda (Object, String)

Článek
08/11/2011

Váže ListObject řízení člena zadaný zdroj 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, _
    dataMember As String _
)

void SetDataBinding(
    Object dataSource,
    string dataMember
)

Parametry

dataSource
Typ: System.Object
objekt slouží jako zdroj dat ListObject řízení.

dataMember
Typ: System.String
DataMember , Určuje vlastnost vazbu v rámci objekt vrácený DataSource.

Výjimky

Výjimka	Podmínka
SetDataBindingFailedException	Nelze vytvořit vazbu na zadaný zdroj dat.
ArgumentException	Jeden nebo více argumentů je neplatných.
ArgumentNullException	dataSource Argument je nullodkaz Null (Nothing v jazyce Visual Basic).

Poznámky

zdroj dat může být libovolný objekt , který implementuje IList, IListSource, IBindingList, nebo IEnumerable.

Datový člen musí být vlastnost zdroj dat , který vrátí kolekcevazbu. Například DataSet zdrojová databáze obsahuje tabulky jako členové data.

Příklady

Následující příklad kódu vytváří DataSet, DataTablea ListObject. Pak sváže seznamu objekt DataSet a DataTable.

Tento příklad je přizpůsobení úrovni dokumentu.

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

        ' Create a data table with two columns.
        Dim ds As New DataSet()
        Dim table As DataTable = ds.Tables.Add("Customers")
        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

        ' Create the list object.
        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(ds, "Customers")

    End Sub

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

    // Create a data table with two columns.
    DataSet ds = new DataSet();
    DataTable table = ds.Tables.Add("Customers");
    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(ds, "Customers");
}

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é

Odkaz

ListObject Rozhraní

SetDataBinding – přetížení

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

Sdílet prostřednictvím