ListObject.DataSource – vlastnost

Článek
05/14/2013

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

Za běhu, použijte SetDataBinding metoda nastavena DataSource a DataMember vlastnosti.

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

A DataTable.
A DataView.
A DataSet.
A DataViewManager.
Součást, která implementuje IListSource rozhraní.
Součást, která implementuje IList rozhraní.

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

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

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

Příklady

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

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

    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