ListObject.SetDataBinding – metoda (Object, String)

Článek
01/03/2014

Váže ListObject ovládací prvek zdroje dat určený datový člen.

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, který chcete použít jako zdroj dat pro ListObject ovládacího prvku.

dataMember
Typ: System.String
DataMember , Který určuje vlastnost vázat v rámci objektu vráceného DataSource.

Výjimky

Výjimka	Podmínka
SetDataBindingFailedException	Nelze vytvořit vazbu na zdroj zadaná data.
ArgumentException	Jeden nebo více parametrů jsou 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.

Datový člen musí být vlastnost zdroj dat, která vrátí kolekci vazbu.Například DataSet zdroje obsahuje tabulky jako datové členy.

Příklady

Následující příklad kódu vytvoří DataSet, DataTablea ListObject.Pak se váže na objekt seznamu DataSet a DataTable.

Tento příklad je pro vlastní úpravy ú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é

Referenční dokumentace

ListObject Rozhraní

SetDataBinding – přetížení

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

Sdílet prostřednictvím