ListObject.SetDataBinding Метод (Object, String) (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, _
    dataMember As String _
)
'Применение
Dim instance As ListObject
Dim dataSource As Object
Dim dataMember As String

instance.SetDataBinding(dataSource, dataMember)

public void SetDataBinding(
    Object dataSource,
    string dataMember
)

Параметры

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

dataMember
Тип: System.String
Элемент DataMember, задающий свойство для привязки в объекте, возвращаемом объектом DataSource.

Исключения

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

Заметки

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

Элементом данных должно быть свойство источника данных, который возвращает коллекцию, которая может быть связана. Например, источник DataSet имеет таблицы как элементы данных.

Примеры

В следующем примере кода создаются DataSet, DataTable и ListObject. Затем выполняется привязка объекта списка к DataSet и к DataTable.

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

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

    ' Create a data table with two columns.
    Dim ds As New DataSet()
    Dim table As DataTable = ds.Tables.Add("Customers")
    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

    ' Create the list object.
    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(ds, "Customers")

End Sub

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

    // Create a data table with two columns.
    DataSet ds = new DataSet();
    DataTable table = ds.Tables.Add("Customers");
    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(ds, "Customers");
}

Разрешения

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