Добавление и настройка элементов управления ReportViewer

Можно добавить один или несколько экземпляров элемента управления ReportViewer в приложение Microsoft Windows или ASP.NET, перетащив элемент управления из раздела «Данные» области элементов Visual Studio на страницу или на форму в приложении. С помощью панели смарт-тегов и свойств можно настроить элемент управления и привязать отчет. Также можно написать код для программной настройки элемента управления.

Элемент управления ReportViewer отображает только одно определение отчета в любой момент времени. Если нужно просматривать несколько отчетов одновременно, можно использовать несколько экземпляров элемента управления на одной странице. Также можно разместить несколько отчетов в одном экземпляре элемента управления при условии, что пользователи будут смотреть не более одного отчета одновременно. Чтобы показывать последовательность отчетов в одном элементе управления, необходимо написать код, который будет связывать отчет с экземпляром элемента управления, в котором он будет использоваться.

Элементы управления ReportViewer работают в режиме локальной обработки или удаленной обработки.

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

В режиме удаленной обработки элемент управления получает полностью обработанный отчет с сервера отчетов служб Microsoft SQL Server 2005 Reporting Services. В режиме удаленной обработки элемент управления ReportViewer выполняет две функции: он служит средством просмотра, а также обеспечивает поддержку интерактивных действий с отчетом. В режиме удаленной обработки все операции по обработке и подготовке к просмотру выполняются на сервере отчетов. Для удаленной обработки необходимо заранее опубликовать отчеты. Отчет можно получить из потока или указать его URL-адрес. В режиме удаленной обработки нельзя использовать RDLC-файлы. Дополнительные сведения см. в разделах LoadReportDefinition, ReportServerUrl и ReportPath.

Внимание!

Для режима удаленной обработки необходима лицензионная копия служб SQL Server 2005 Reporting Services. Удаленная обработка предназначена для поддержки организаций, которые обладают сервером отчетов служб SQL Server Reporting Services и намерены использовать его вместе с элементами управления. Серверное решение обеспечивает лучшую масштабируемость и производительность, а также предлагает дополнительные функции, такие как подписки, кэширование и более широкий выбор выходных форматов отчета. Важно заметить, что в результате удаленной обработки в отчет вносятся некоторые визуальные и функциональные изменения. Дополнительные сведения о режиме удаленной обработки см. в разделах Настройка ReportViewer для удаленной обработки и Развертывание отчетов и элементов управления ReportViewer.

Как добавить и настроить элемент управления ReportViewer

1. Добавьте в проект форму Windows или веб-страницу.

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

3. На панели смарт-тегов Задачи ReportViewer выберите задачи для добавления отчета и настройки элемента управления. При задании отчета определяется, как будет настроен элемент управления — для локальной или удаленной обработки.

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

   • В поле Выберите отчет выберите существующее определение отчета. Можно выбрать RDLC-файл, который определен в проекте, или указать пункт Серверный отчет, чтобы выбрать отчет, опубликованный на сервере отчетов служб SQL Server 2005 Reporting Services.

     После выбора серверного отчета элемент управления настраивается на удаленную обработку. Чтобы выбрать серверный отчет, необходимо знать URL-адрес сервера отчетов и путь к отчету. Путь к отчету должен начинаться с косой черты (/). Для выполнения отчета необходимо иметь на сервере отчетов разрешения на доступ к отчету. Если URL-адрес или путь к отчету неизвестны, обратитесь к администратору сервера отчетов. Дополнительные сведения о серверных отчетах см. в разделе Настройка ReportViewer для удаленной обработки.

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

   • Щелкните элемент Закрепление в родительском контейнере, чтобы развернуть область просмотра элемента управления ReportViewer, заняв все доступное место на форме или на странице. Эта возможность доступна для элемента управления Windows Forms.

   • Щелкните элемент Повторно привязать источники данных, чтобы обновить привязки источников данных для таблицы данных и бизнес-объектов, используемых в отчете. Эта возможность доступна после выбора отчета для элемента управления. Повторную привязку источника данных необходимо выполнить, если изменяется источник данных отчета или если привязанный к данным элемент отчета изменяется вне среды графического конструктора отчетов (например, если XML-код редактируется непосредственно).

4. Выберите элемент управления ReportViewer и откройте окно «Свойства».

5. Задайте свойства для элемента управления ReportViewer, чтобы определить видимость и доступность областей просмотра. Чтобы получить сведения о каждом свойстве, обратитесь к справочной документации. Дополнительные сведения см. в разделе Свойства ReportViewer. Сведения о панели инструментов ReportViewer см. в разделе Настройка и использование панели инструментов ReportViewer.

6. Постройте или разверните приложение, чтобы просмотреть отчет в пределах формы или страницы.

См. также

Понятия

Использование панели смарт-тегов для задач ReportViewer
Создание клиентских RDLC-файлов
Настройка ReportViewer для локальной обработки
Настройка ReportViewer для удаленной обработки
Настройка вложенных отчетов и детализированных отчетов (конструктор отчетов Visual Studio)
Серверный веб-элемент управления ReportViewer и соответствующий элемент управления Windows Forms

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

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