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

Статья
05/06/2011

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

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

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

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

В режиме удаленной обработки элемент управления получает полностью обработанный отчет с сервера отчетов служб Reporting Services. В режиме удаленной обработки все операции по обработке данных и обработке отчета выполняются на сервере отчетов. Режим удаленной обработки обычно используется для заранее опубликованных отчетов, однако можно воспользоваться удаленной обработкой для определения отчета, который предоставляется с помощью потока. Дополнительные сведения см. в разделах LoadReportDefinition, ReportServerUrl и ReportPath.

Важно!

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

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

Добавьте форму Windows Forms или веб-форму в проект .NET Framework 3.5 или 4.0.
В режиме графического конструктора перетащите элемент управления ReportViewer из группы Отчет в области элементов на форму Windows или веб-форму. В элемент управления входит панель смарт-тегов Задачи ReportViewer, с помощью которой можно сразу выбрать отчет.

Файл web.config автоматически обновляется с использованием обработчика HTTP-данных для элемента управления ReportViewer. Дополнительные сведения см. в разделе Параметры файла web.config для ReportViewer.

Примечание

Для использования элемента управления ReportViewer в веб-форме необходимо также добавить на страницу элемент управления ScriptManager. Перетащите элемент управления ScriptManager из группы Расширения AJAX окна Область элементов в область конструктора над элементом управления ReportViewer.
На панели смарт-тегов Задачи ReportViewer выберите задачи для добавления отчета и настройки элемента управления. При задании отчета определяется, как будет настроен элемент управления — для локальной или удаленной обработки.
- Выберите пункт Создать новый отчет, чтобы запустить мастер отчетов и создать RDLC-файл в приложении. В приложении можно создавать новые отчеты, которые обрабатываются локальным образом на клиенте. Дополнительные сведения о создании отчетов см. в разделе Создание клиентских RDLC-файлов.
- В поле Выберите отчет выберите существующее определение отчета. Можно выбрать локальное определение отчета (RDLC-файл), который определен в проекте, или выбрать пункт Серверный отчет, чтобы выбрать отчет, опубликованный на сервере отчетов служб SQL Server 2008 Reporting Services.
  
  После выбора серверного отчета элемент управления настраивается на удаленную обработку. Чтобы выбрать серверный отчет, необходимо знать URL-адрес сервера отчетов и путь к отчету. Путь к отчету, который ссылается на отчет, расположенный на сервере отчетов в собственном режиме, начинается с косой черты (/). Путь к отчету, который ссылается на отчет на сервере отчетов в режиме интеграции с SharePoint, представляет полный URL-адрес. Пример.
  
  Собственный режим: /Adventureworks 2008 Sample Reports/Company Sales 2008
  
  Режим интеграции с SharePoint: http://MyServer/sites/MySite/MyLibrary/Adventureworks 2008 Sample Reports/Company Sales 2008.rdl
  
  Для выполнения отчета необходимо иметь на сервере отчетов разрешения на доступ к отчету. Если URL-адрес или путь к отчету неизвестны, обратитесь к администратору сервера отчетов. Дополнительные сведения о серверных отчетах см. в разделе Настройка ReportViewer для удаленной обработки.
  
  После выбора существующего RDLC-файла элемент управления настраивается на локальную обработку. Во время выбора отчета необходимо выбрать RDLC-файл, при этом нельзя указать RDL-файл, даже если он существует в проекте. Дополнительные сведения см. в разделе Создание клиентских RDLC-файлов.
- Щелкните элемент Закрепление в родительском контейнере, чтобы развернуть область просмотра элемента управления ReportViewer, заняв все доступное место на форме или на странице. Эта возможность доступна для элемента управления Windows Forms.
- Щелкните элемент Повторно привязать источники данных, чтобы обновить привязки источников данных для таблицы данных и бизнес-объектов, используемых в отчете. Эта возможность доступна после выбора отчета для элемента управления. Повторную привязку источника данных необходимо выполнить, если изменяется источник данных отчета или если привязанный к данным элемент отчета изменяется вне среды графического конструктора отчетов (например, если XML-код редактируется непосредственно).
Выберите элемент управления ReportViewer и откройте окно Свойства.
Задайте свойства для элемента управления ReportViewer, чтобы определить видимость и доступность областей просмотра. Чтобы получить сведения о каждом свойстве, обратитесь к справочной документации. Дополнительные сведения см. в разделе Свойства ReportViewer. Сведения о панели инструментов ReportViewer см. в разделе Настройка и использование панели инструментов ReportViewer.
Постройте или разверните приложение, чтобы просмотреть отчет в пределах формы или страницы.