ListObject.SetDataBinding – metoda (Object, String)

Článek
05/14/2013

Váže ListObject členem zadaná data ze zdroje dat ovládacího prvku.

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 knihovnou DataSource.

Výjimky

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

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

Příklady

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

V tomto příkladu je úroveň dokument přizpůsobení.

    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