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

Článek
08/11/2011

Váže ListObject řízení zadaná data členem zdroj data zobrazí pouze zadané sloupce tohoto člena data.

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 slouží jako zdroj dat ListObject řízení.

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

mappedColumns
Typ: array<System.String[]
Názvy sloupců datového člena, který chcete zobrazit v ListObject řízení.Chcete-li přidat nenamapované sloupec zahrňte prázdný řetězec pole.

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

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

dataMemberparametr 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 ListObject se DataSet a DataTable, ale obsahuje pouze jeden dva možné tabulky sloupce v ListObject.

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

    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é

Odkaz

ListObject Rozhraní

SetDataBinding – přetížení

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

Sdílet prostřednictvím