ListObject.SetDataBinding Метод (Object) (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Связывает элемент управления ListObject с источником данных.

Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel.v9.0 (в Microsoft.Office.Tools.Excel.v9.0.dll)

Синтаксис

'Декларация
Public Sub SetDataBinding ( _
    dataSource As Object _
)
'Применение
Dim instance As ListObject
Dim dataSource As Object

instance.SetDataBinding(dataSource)

public void SetDataBinding(
    Object dataSource
)

Параметры

dataSource
Тип: System.Object
Объект, который требуется использовать в качестве источника данных для элемента управления ListObject.

Исключения

Исключение	Условие
SetDataBindingFailedException	Не удалось выполнить привязку к указанному источнику данных.
ArgumentException	Аргумент является недопустимым.
ArgumentNullException	Аргумент dataSource имеет значение nullссылка null (Nothing в Visual Basic).

Заметки

Источником данных может быть любой объект, который реализует объект IList, IListSource, IBindingList, или IEnumerable, например DataTable или одномерный массив.

Примеры

В следующем примере кода показано, как использовать метод SetDataBinding для привязки ListObject к DataTable. Объект DataTable имеет два столбца, содержащих имена и возраст сотрудников, а также четыре строки, представляющих записи сотрудников.

В этом примере демонстрируется настройка уровня документа.

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

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.