ListObject.DataSource - свойство

Статья
08/11/2011

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

Пространство имен: 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пустая ссылка (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";
}

Безопасность платформы .NET Framework

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

См. также

Ссылки

ListObject Интерфейс

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

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