ListObject.DataSource Özellik

Makale
10/29/2012

Alır veya Denetim içindeki öğeleri doldurmak için kullanılan değerler listesini içeren kaynak ayarlar.

Ad alanı: Microsoft.Office.Tools.Excel
Derleme: Microsoft.Office.Tools.Excel (Microsoft.Office.Tools.Excel.dll içinde)

Sözdizimi

'Bildirim
Property DataSource As Object

Object DataSource { get; set; }

Özellik Değeri

Tür: System.Object
Denetim içindeki öğeleri doldurmak için kullanılan değerler listesini içeren kaynak.nullnull başvuru (Visual Basic'te Nothing) varsayılan değerdir.

Notlar

Çalışma zamanında SetDataBinding yöntem DataSource ve DataMember özellikleri.

Aşağıdaki veri kaynakları geçerlidir:

DataTable
DataView
DataSet
DataViewManager
Uygulayan herhangi bir bileşenin IListSource arabirim.
Uygulayan herhangi bir bileşenin IList arabirim.

Bkz: Binding veri kaynakları hakkında daha fazla bilgi için sınıfına genel bakış.

DataSource Birden fazla tablo veya özellik başvuru içeriyorsa, ayarlamanız gerekir DataMember özelliğine bağlamak için tabloyu belirten bir dize.Örneğin, DataSource olan bir DataSet veya DataViewManager müşteriler, siparişler ve OrderDetails adlı üç tablo varsa, tablo bağlamak için belirtmeniz gerekir.

Ayarlama DataSource uygulamayan bir nesneye IList arabirimini veya bir IListSource istisna özel durumunun oluşturulmasına neden olur.

Örnekler

Aşağıdaki kod örneği, iki DataTable nesnesiyle birlikte DataSet oluşturur ve tablolardan birini veriyle doldurur.Kod daha sonra ayarlar DataSource ve DataMember özelliklerini ListObject veri içeren tabloyu bağlamak.

Bu örnek için belge düzeyi özelleştirmesinde içindir.

    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";
}

.NET Framework Güvenliği

Anında arayanlar için tam güven. Bu üye kısmen güvenilen kodla kullanılamaz. Daha fazla bilgi için bkz. Kısmen güvenilen kod kitaplıklarını kullanma.

Ayrıca bkz.

Başvuru

ListObject Arabirim

Microsoft.Office.Tools.Excel Ad Alanı

Aracılığıyla paylaş