مشاركة عبر

ListObject.DataSource الخاصية

  • مقالة

الحصول أو تعيين مصدر البيانات الذي يحتوي على قائمة بالقيم التي يتم استخدامها لتجميع عناصر الموجودة داخل عنصر تحكم.

مساحة الاسم:  Microsoft.Office.Tools.Excel
التجميع:  Microsoft.Office.Tools.Excel (في Microsoft.Office.Tools.Excel.dll)

بناء الجملة

'إقرار
Property DataSource As Object
    Get
    Set

Object DataSource { get; set; }

قيمة الخاصية

النوع: System.Object
مصدر البيانات الذي يحتوي على قائمة بالقيم التي يتم استخدامها لتجميع عناصر الموجودة داخل عنصر تحكم.القيمة الافتراضية هي nullمرجع خالٍ (لا شيء في Visual Basic).

ملاحظات

في وقت التشغيل، استخدم SetDataBindingأسلوب إلى تعيين DataSourceو DataMemberالخصائص.

يلي المصادر بيانات صالحة:

راجع Bindingنظرة عامة حول فئة للحصول تشغيل مزيد من المعلومات حول المصادر بيانات.

إذا DataSourceمرجع يحتوي على المزيد جدول أو خاصية، يجب عليك التعيين DataMemberخاصية إلى سلسلة تحدد جدول الربط. على سبيل المثال، إذا كان DataSourceهو DataSetأو DataViewManagerيحتوي على الجداول الثلاثة المسماة Cusإلىmers و Orders (الطلبيات) و OrderDetails، قم بتحديد الجدول إلى يربط إلى.

تعيين DataSourceإلى كائن لا تطبق IListواجهة أو IListSourceسيؤدي إلى أن يتم طرح استثناء.

أمثلة

مثال التعليمات البرمجية التالي يقوم بإنشاء DataSet مع كائني DataTable و يقوم بملء أحد الجداول بالبيانات. تعليمات برمجية ثم تعيين DataSourceو DataMemberخصائص ListObjectإلى يربط إلى الجدول الذي يحتوي على بيانات.

Th هو المثال هو لتخصيص المستوى مستند.

    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", missing], "Customers");

    // Bind the list object to the Customers table.
    list1.AutoSetDataBoundColumnHeaders = true;
    list1.DataSource = ordersDataSet;
    list1.DataMember = "Customers";
}

أمن NET Framework.

راجع أيضًَا

المرجع

ListObject واجهة

ListObject الأعضاء

Microsoft.Office.Tools.Excel مساحة الاسم