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


Создание источников данных для отчета

RDLC-файл включает элементы набора данных, которые определяют структуру источника данных, используемого отчетом. Перед использованием данных в определении отчета необходимо добавить в отчет один или несколько наборов данных. После создания набора данных можно перетащить отдельное поле в область данных или в текстовое поле в отчете.

RDLC-файлы обрабатываются элементом управления ReportViewer как локальные отчеты. В отличие от серверных отчетов, для локальных отчетов необходимо обрабатывать данные до того, как элемент управления ReportViewer начнет обработку отчетов. Локальные отчеты могут использовать данные из любого источника при условии, что они могут передаваться в виде объекта DataTable или коллекции бизнес-объектов IEnumerable. Таблица данных или бизнес-объект возвращает список полей, которые могут использоваться в отчете. Каждое поле содержит указатель на поле базы данных и свойство имени, поле в источнике данных объекта или столбец в таблице DataTable. Поля можно перетаскивать из окна Данные отчета в область конструктора отчета.

Настройка источников данных в проекте

Для настройки объекта DataSet или перечисления бизнес-объектов IEnumerable в качестве источника данных отчета рекомендуются следующие методы. После настройки источника данных можно привязать объект DataSet или бизнес-объекты к отчету.

Использование таблиц данных

Чтобы создать объект DataTable, используйте команду Добавить новый элемент из меню Проект и выберите объект Набор данных. Перетащите элемент Адаптер таблицы из области элементов в окно Редактор наборов данных, чтобы настроить DataTable в мастере адаптера таблицы. Мастер TableAdapter предоставляет построитель запросов и функцию предварительного просмотра данных для мгновенного определения правильности результатов запроса.

Использование бизнес-объектов

Бизнес-объект — это любой объект приложения, предоставляющий доступ к открытым свойствам простых типов данных. Например, массив объектов «Название книги», созданный приложением, представляет бизнес-объект, который может использоваться в качестве источника данных для отчета.

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

Для проектов Windows Forms или ASP.NET выполняются различные действия по использованию бизнес-объектов. Инструкции по использованию бизнес-объектов в Windows Forms см. в разделе Пошаговое руководство. Использование источника данных бизнес-объекта с элементом управления ReportViewer для Windows Forms в режиме локальной обработки. Инструкции по использованию бизнес-объектов в ASP.NET см. в разделе Пошаговое руководство. Использование источника данных бизнес-объекта с серверным веб-элементом управления ReportViewer в режиме локальной обработки.

Привязка данных к отчету

RDLC-файлы привязываются к объектам DataSet или бизнес-объектам, содержащим необходимые данные. Если отчет создается в мастере отчетов, мастер помогает выполнить действия по созданию объекта DataSet с необходимыми данными и привязке его к отчету. Также можно вручную привязать объект DataSet или бизнес-объект к отчету в окне Данные отчета. В этом окне выводятся все наборы данных, привязанные к отчету, с группированием по объектам DataSet.

Привязка набора данных к отчету

  1. В окне Данные отчета конструктора отчетов нажмите кнопку Создать и выберите пункт Набор данных.

  2. В списке Источник данных выберите созданный объект DataSet. Чтобы создать новый объект DataSet, нажмите кнопку Создать и выполните действия в мастере настройки источника данных, входящем в состав Visual Studio. Если создан бизнес-объект, выберите пункт глобальный для доступа к нему.

  3. В списке Доступные наборы данных выберите данные, к которым выполняется привязка. В этом списке выводятся доступные объекты DataTable или бизнес-объекты.

  4. В поле Имя укажите имя для этого набора данных и нажмите кнопку ОК.

Если схемы DataSet будут изменяться после определения отчета, необходимо обновить привязки данных в отчете и в элементе управления. Дополнительные сведения см. в разделе Обновление и повторная привязка ссылок на источники данных (конструктор отчетов Visual Studio).

В отчете можно использовать любое число наборов данных. Чтобы просмотреть список наборов данных, которые фактически используются в отчете, выберите в меню Вид пункт Данные отчета. Для просмотра отчета и его данных в приложении нужно построить или развернуть приложение, чтобы убедиться, что отчет содержит ожидаемые данные. Дополнительные сведения о настройке элемента управления и определении макета отчета см. в разделах Настройка ReportViewer для локальной обработки и Создание клиентских RDLC-файлов.

Чтобы начать немедленно, используйте следующие пошаговые руководства, в которых показано добавление в проект различных типов источников данных:

Определение источников данных для серверных веб-элементов управления ReportViewer

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

При создании веб-страницы в разделе Данные области элементов перечисляются элементы управления источников данных, например SqlDataSource и XmlDataSource. Некоторые элементы управления источников данных поддерживают страничную память для веб-страниц, а другие используют общий доступ к данным. Отчеты не используют страничную память, так что при работе с серверным веб-элементом управления ReportViewer лучше всего использовать элемент управления ObjectDataSource. Этот элемент управления обеспечивает связь между кэшированными объектами в памяти (DataTable или коллекциями бизнес-объектов) и отчетом. При добавлении на веб-страницу управляющего элемента ReportViewer автоматически добавляется и настраивается элемент ObjectDataSource.

См. также

Справочник

ReportViewer.Drillthrough

LocalReport.SubreportProcessing

ReportViewer.Drillthrough

LocalReport.SubreportProcessing

Основные понятия

Настройка ReportViewer для удаленной обработки

Обновление и повторная привязка ссылок на источники данных (конструктор отчетов Visual Studio)

Другие ресурсы

TableAdapter Overview

Образцы и пошаговые руководства