ListObject.SetDataBinding – metoda (Object, String, array<String )

Článek
05/14/2013

Váže ListObject ovládací prvek zadaný datový člen ze zdroje dat a zobrazí pouze zadané sloupce datového člena.

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, _
    ParamArray mappedColumns As String() _
)

void SetDataBinding(
    Object dataSource,
    string dataMember,
    params string[] mappedColumns
)

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.

mappedColumns
Typ: array<System.String[]
Názvy sloupců v datovém členu, který se má zobrazit v ListObject ovládacího prvku.Chcete-li přidat sloupec nenamapované obsahovat prázdný řetězec v poli.

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

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

dataMember Parametr 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 naváže ListObject na DataSet a DataTable, ale obsahuje pouze jeden dva sloupce tabulky možné ListObject.

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

    Private Sub ListObject_SetDataBinding3()
        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.
        Dim mappedColumn As String() = {"Names"}
        List1.SetDataBinding(ds, "Customers", mappedColumn)

    End Sub

private void ListObject_SetDataBinding3()
{
    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.
    string[] mappedColumn = { "Names" };
    list1.SetDataBinding(ds, "Customers", mappedColumn);
}

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