ListObject.SetDataBinding أسلوب (Object)

مقالة
09/21/2010

بربط ListObjectعنصر تحكم لمصدر بيانات.

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

بناء الجملة

'إقرار
Sub SetDataBinding ( _
    dataSource As Object _
)

void SetDataBinding(
    Object dataSource
)

المعلمات

dataSource
النوع: System.Object
الكائن المراد استخدامه كمصدر بيانات ل ListObjectعنصر تحكم.

استثناءات

استثناء:	شرط
SetDataBindingFailedException	تعذر الربط إلى بمصدر بيانات المحدد.
ArgumentException	وسيطة هو غير صالح.
ArgumentNullException	dataSourceوسيطة nullمرجع خالٍ (لا شيء في Visual Basic).

ملاحظات

يمكن أن يكون مصدر بيانات أي كائن يطبق IList، IListSource، IBindingList، أو IEnumerable، مثل كـ DataTableأو الصفيف أحادي الأبعاد.

أمثلة

يوضح مثال التعليمة البرمجية التالية كيف إلى استخدام SetDataBindingأسلوب إلى يربط ListObjectإلى DataTable. DataTableيحتوي على عمودين، والتي تحتوي على الأسماء والإعمار للموظفين، وأربعة صفوف تمثل إدخالات "الموظفين".

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

    Private Sub ListObject_SetDataBinding()
        Dim Ages As Integer() = {32, 44, 28, 61}
        Dim Names As String() = {"Reggie", "Sally", _
            "Henry", "Christine"}

        ' Create a data table with two columns.
        Dim table = New DataTable()
        Dim column1 As New DataColumn("Names", GetType(String))
        Dim column2 As New DataColumn("Ages", GetType(Integer))
        table.Columns.Add(column1)
        table.Columns.Add(column2)

        ' Add the four rows of data to the table.
        Dim row As DataRow
        Dim i As Integer
        For i = 0 To 3
            row = table.NewRow()
            row("Names") = Names(i)
            row("Ages") = Ages(i)
            table.Rows.Add(row)
        Next i

        Dim List1 As Microsoft.Office.Tools.Excel.ListObject = _
            Me.Controls.AddListObject(Me.Range("A1", "B4"), "List1")

        ' Bind the list object to the table.
        List1.SetDataBinding(table)

    End Sub

private void ListObject_SetDataBinding()
{
    int[] Ages = { 32, 44, 28, 61 };
    string[] Names = { "Reggie", "Sally", "Henry", "Christine" };

    // Create a data table with two columns.
    System.Data.DataTable table = new DataTable();
    DataColumn column1 = new DataColumn("Names", typeof(string));
    DataColumn column2 = new DataColumn("Ages", typeof(int));
    table.Columns.Add(column1);
    table.Columns.Add(column2);

    // Add the four rows of data to the table.
    DataRow row;
    for (int i = 0; i < 4; i++)
    {
        row = table.NewRow();
        row["Names"] = Names[i];
        row["Ages"] = Ages[i];
        table.Rows.Add(row);
    }

    Microsoft.Office.Tools.Excel.ListObject list1 =
        this.Controls.AddListObject(this.Range["A1", "B4"], "list1");

    // Bind the list object to the table.
    list1.SetDataBinding(table);
}

أمن NET Framework.

الثقة الكاملة للمتصل الفوري. يتعذر استخدام هذا العضو بواسطة التعليمات البرمجية الموثوق بها جزئيًا. لمزيد من المعلومات، راجع باستخدام مكتبات من تعليمات برمجية موثوق بها جزئي.