ListObject.DataSource Özellik

Makale
02/17/2014

Alır veya Denetim içindeki öğeleri doldurmak için kullanılan değerler listesini içeren kaynağını 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 kaynağı.Varsayılan değer nullnull başvuru (Visual Basic'te Nothing).

Notlar

Çalışma zamanında SetDataBinding yöntemini ayarlamak için DataSource ve DataMember özellikleri.

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

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

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

Yoksa DataSource başvuru içeren birden fazla tablo veya özelliği, 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 Sipariş Ayrıntıları adlı üç tablo içeriyorsa, bağlamak için tablo belirtmeniz gerekir.

Ayarlama DataSource uygulamayan bir nesneye IList arabirimini veya bir IListSource bir özel durum 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 için.

Belge düzeyi özelleştirmesi için örnektir.

    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 Koddan Kitaplıkları Kullanma.

Ayrıca bkz.

Başvuru

ListObject Arabirim

Microsoft.Office.Tools.Excel Ad Alanı

Aracılığıyla paylaş