ListObject.DataSource – vlastnost

Článek
01/03/2014

Získá nebo nastaví zdroj, který obsahuje seznam hodnot, které se používají k naplnění položek v ovládacím prvku.

Obor názvů: Microsoft.Office.Tools.Excel
Sestavení: Microsoft.Office.Tools.Excel (v Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Deklarace
Property DataSource As Object

Object DataSource { get; set; }

Hodnota vlastnosti

Typ: System.Object
Zdroj, který obsahuje seznam hodnot, které se používají k naplnění položek v ovládacím prvku.Výchozí hodnota je nullodkaz null (Nothing v jazyce Visual Basic).

Poznámky

V době běhu použít SetDataBinding metoda pro nastavení DataSource a DataMember vlastnosti.

Platné jsou následující zdroje dat:

Objekt DataTable
Objekt DataView
Objekt DataSet
Objekt DataViewManager
Jakékoli součásti, která implementuje IListSource rozhraní.
Jakékoli součásti, která implementuje IList rozhraní.

Najdete Binding Další informace o zdrojích dat v přehledu třídy.

Pokud DataSource odkaz obsahuje více než jednu tabulku nebo vlastnost, musíte nastavit DataMember vlastnost na řetězec, který určuje tabulku svázat.Například pokud DataSource je DataSet nebo DataViewManager , která obsahuje tři tabulky s názvy Zákazníci, objednávky a Rozpis objednávek, je nutné zadat tabulku svázat.

Nastavení DataSource objekt, který neimplementuje IList rozhraní nebo IListSource způsobí výjimku být vyvolána.

Příklady

Následující příklad kódu vytvoří DataSet se dvěma DataTable objekty a naplní jednu z tabulek s daty.Kód potom nastaví DataSource a DataMember vlastnosti ListObject vytvořit vazbu na tabulku, která obsahuje data.

Tento příklad je pro vlastní úpravy úrovni dokumentu.

    Private Sub ListObject_DataSourceAndMember()
        ' Create a DataSet and two DataTables.
        Dim ordersDataSet As New DataSet("ordersDataSet")
        Dim tableCustomers As New DataTable("Customers")
        Dim tableProducts As New DataTable("Products")
        ordersDataSet.Tables.Add(tableCustomers)
        ordersDataSet.Tables.Add(tableProducts)

        ' Add a data to the Customers DataTable.
        tableCustomers.Columns.Add(New DataColumn("LastName"))
        tableCustomers.Columns.Add(New DataColumn("FirstName"))
        Dim dr As DataRow = tableCustomers.NewRow()
        dr("LastName") = "Chan"
        dr("FirstName") = "Gareth"
        tableCustomers.Rows.Add(dr)

        ' Create a list object.
        Dim List1 As Microsoft.Office.Tools.Excel.ListObject = _
            Me.Controls.AddListObject(Me.Range( _
            "A1"), "Customers")

        ' Bind the list object to the Customers table.
        List1.AutoSetDataBoundColumnHeaders = True
        List1.DataSource = ordersDataSet
        List1.DataMember = "Customers"

    End Sub

private void ListObject_DataSourceAndMember()
{
    // Create a DataSet and two DataTables.
    DataSet ordersDataSet = new DataSet("ordersDataSet");
    DataTable tableCustomers = new DataTable("Customers");
    DataTable tableProducts = new DataTable("Products");
    ordersDataSet.Tables.Add(tableCustomers);
    ordersDataSet.Tables.Add(tableProducts);

    // Add a data to the Customers DataTable.
    tableCustomers.Columns.Add(new DataColumn("LastName"));
    tableCustomers.Columns.Add(new DataColumn("FirstName"));
    DataRow dr = tableCustomers.NewRow();
    dr["LastName"] = "Chan";
    dr["FirstName"] = "Gareth";
    tableCustomers.Rows.Add(dr);

    // Create a list object.
    Microsoft.Office.Tools.Excel.ListObject list1 = 
        this.Controls.AddListObject(
        this.Range["A1"], "Customers");

    // Bind the list object to the Customers table.
    list1.AutoSetDataBoundColumnHeaders = true;
    list1.DataSource = ordersDataSet;
    list1.DataMember = "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í

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

Sdílet prostřednictvím