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

  • Článek

Váže ListObject ovládacího prvku na zadaný datový člen ze zdroje dat a zobrazí pouze zadané sloupce tohoto 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

  • mappedColumns
    Typ: array<System.String[]
    Názvy sloupců v datovém členu, který chcete zobrazit v ListObject ovládacího prvku.Přidáte nenamapované sloupce obsahovat prázdný řetězec v poli.

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

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

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

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

Viz také

Referenční dokumentace

ListObject Rozhraní

SetDataBinding – přetížení

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