ListObject.DataSource Свойство (2007 System)

Статья
11/16/2008

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

Возвращает или задает источник, содержащий список значений, используемых для заполнения элементов в элементе управления.

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

Синтаксис

'Декларация
Public Property DataSource As Object
'Применение
Dim instance As ListObject
Dim value As Object

value = instance.DataSource

instance.DataSource = value

public Object DataSource { get; set; }

Значение свойства

Тип: System.Object
Источник, содержащий список значений, используемых для заполнения элементов в элементе управления. Значение по умолчанию: nullссылка null (Nothing в Visual Basic).

Заметки

Во время выполнения метод SetDataBinding используется для задания свойств DataSource и DataMember.

Допустимы следующие источники данных:

Класс DataTable.
Класс DataView.
Класс DataSet.
Класс DataViewManager.
Любой компонент, реализующий интерфейс IListSource.
Любой компонент, реализующий интерфейс IList.

Дополнительные сведения об источниках данных см. в общих сведениях о классе Binding.

Если ссылка DataSource содержит несколько таблиц или свойств, необходимо установить свойство DataMember на строку, указывающую таблицу для привязки. Например, если DataSource является набором данных DataSet или DataViewManager, содержащим три таблицы с названиями Customers, Orders и OrderDetails, необходимо указать таблицу для привязки.

При установке свойства DataSource на объект, не реализующий интерфейс IList или IListSource, возникает исключение.

Примеры

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

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

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

Разрешения

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

См. также

Ссылки

ListObject Класс

ListObject - члены

Microsoft.Office.Tools.Excel - пространство имен

Поделиться через