Udostępnij za pośrednictwem

Właściwość ListObject.DataSource —

  • Artykuł

Pobiera lub ustawia źródło, które zawiera listę wartości, które są używane do wprowadzania elementów znajdujących się pod kontrolą.

Przestrzeń nazw:  Microsoft.Office.Tools.Excel
Zestaw:  Microsoft.Office.Tools.Excel (w Microsoft.Office.Tools.Excel.dll)

Składnia

'Deklaracja
Property DataSource As Object

Object DataSource { get; set; }

Wartość właściwości

Typ: System.Object
Źródło, które zawiera listę wartości, które są używane do wprowadzania elementów znajdujących się pod kontrolą.Wartością domyślną jest nullodwołanie o wartości null (Nothing w języku Visual Basic).

Uwagi

W czasie wykonywania należy użyć SetDataBinding Metoda wyznaczenia DataSource i DataMember właściwości.

Następujące źródła danych są prawidłowe:

Zobacz Binding Omówienie klasy więcej informacji na temat źródeł danych.

Jeśli DataSource odwołanie zawiera więcej niż jedną tabelę lub właściwość, należy ustawić DataMember właściwość, aby ciąg, który określa tabelę, aby powiązać.Na przykład jeśli DataSource jest DataSet lub DataViewManager zawiera trzy tabele o nazwie Klienci, zamówienia i SzczegółyZamówień, należy określić tabelę, aby powiązać.

Ustawienie DataSource do obiektu, który nie implementuje IList interfejsu lub IListSource spowoduje, że w drodze wyjątku, zostać wygenerowany.

Przykłady

Poniższy przykład kodu tworzy DataSet z dwoma DataTable obiektów i wypełnia jednej z tabel z danymi.Kod następnie ustawia DataSource i DataMember właściwości ListObject powiązać z tabeli, która zawiera dane.

Ten przykład dotyczy dostosowywania poziomie 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";
}

Zabezpieczenia programu .NET Framework

Zobacz też

Informacje

ListObject Interfejs

Przestrzeń nazw Microsoft.Office.Tools.Excel