Настройка и использование панели инструментов ReportViewer

Статья
05/06/2011

Чтобы настроить элемент управления ReportViewer и панель инструментов ReportViewer можно задать свойства в окне «Свойства» или в программном коде. Можно удалить или отключить отдельные команды и задать значения, используемые для инициализации панели инструментов. Дополнительные сведения о свойствах серверного веб-элемента управления ReportViewer см. в разделе Свойства Microsoft.Reporting.WebForms.ReportViewer. Дополнительные сведения о свойствах элемента управления Windows Forms см. в разделе Свойства Microsoft.Reporting.WinForms.ReportViewer.

Панель инструментов ReportViewer

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

Панель инструментов ReportViewer

Примечание

Из-за различий в подготовке элементов пользовательского интерфейса к просмотру в форматах HTML и GDI панель инструментов отчета меняется в зависимости от используемого элемента управления — серверного веб-элемента или элемента Windows Forms.

Схемы документа

Схема документа — это область навигации, содержащая список ссылок, которые пользователи могут использовать для перехода в определенную область отчета. Схема документа представляет сворачиваемое разделенное поле в левой части области просмотра отчета (или в правой части в среде с ориентацией справа налево). Схема документа существует не во всех отчетах. Чтобы отображать схему в средстве просмотра отчетов, необходимо определить ее в определении отчета. Дополнительные сведения о схемах документа и других интерактивных функциях отчета см. в разделе Добавление в отчет интерактивных функций, средств изменения видимости и элементов навигации (конструктор отчетов Visual Studio).

Переход по отчету

На панели инструментов ReportViewer находятся разнообразные функции для перехода по страницам. Пользователь может выбрать определенную страницу или перейти сразу к первой или последней странице. Страницы определяются по разрывам страницы, которые явно задаются в определении отчета. Разрывы страницы также можно вычислить автоматически, в зависимости от используемого выходного формата отчета. Дополнительные сведения см. в разделе Определение размера страницы и разрывов страниц в отчете (конструктор отчетов Visual Studio).

Поскольку элемент управления ASP.NET ReportViewer по умолчанию использует асинхронную обратную передачу для интерактивных функций, пользователь не может нажимать кнопку Назад в обозревателе, если свойство InteractivityPostBackMode не установлено в значение AlwaysSynchronous.

Для навигации по детализированным отчетам пользователь может нажимать кнопку Назад к родительскому отчету на панели инструментов ReportViewer или кнопку Назад в обозревателе, если необходимым образом установлено свойство InteractivityPostBackMode. Однако рекомендуется разрабатывать приложение с учетом одного параметра навигации, чтобы сохранять согласованное состояние сеанса при навигации пользователя по детализированным отчетам. В противном случае пользователь может получить сообщение об ошибке «Обратный вызов без детализированного отчета» при навигации по детализированным отчетам. Чтобы оставить пользователю только один параметр навигации, можно выполнить следующие действия.

Использовать режим AlwaysAsynchronous и установить свойство ShowBackButton в значение true.
Использовать режим AlwaysSynchronous или SynchronousOnDrillthrough и установить свойство ShowBackButton в значение false. В этом случае пользователь сможет только нажимать кнопку Назад в обозревателе. Заметьте, что в этом параметре не используются функции AJAX серверного веб-элемента управления.

Остановка и обновление отчета

В серверном веб-элементе управления пользователь может щелкнуть ссылку отмена в индикаторе состояния занятости, чтобы отменить подготовку отчета к просмотру. В элементе управления Windows Forms пользователь может нажать кнопку Остановить на панели инструментов ReportViewer, чтобы отменить подготовку отчета к просмотру. Чтобы запустить подготовку отчета к просмотру, пользователь может нажать кнопку Обновить.

Когда пользователь нажимает кнопку Обновить для серверного отчета, сервер отчетов повторно обработает отчет, используя последние данные. Учтите, что последние данные определяются с учетом политик кэширования и моментальных снимков, заданных для отчета.

Когда пользователь нажимает кнопку Обновить для локального отчета, могут выполняться другие действия. Поскольку локально обрабатываемые отчеты используют данные, которые предоставляются приложением, во время операций обновления может понадобиться обновить источник данных, предоставив код, который обрабатывает событие ReportViewer.ReportRefresh. Если не обработать это событие для элемента управления Windows Forms, то в результате нажатия кнопки Обновить отчет будет обновлен по старым данным в приложении. Дополнительные сведения о событии ReportViewer.ReportRefresh для серверного веб-элемента управления см. в разделе ReportRefresh. Дополнительные сведения о версии элемента управления Windows Forms см. в разделе ReportRefresh.

Печать отчета

Панель инструментов ReportViewer обеспечивает поддержку печати. Поддержка печати в каждой версии элемента управления ReportViewer реализована по-разному. Более того, серверный веб-элемент управления поддерживает печать только в Internet Explorer. Дополнительные сведения см. в разделе Печать отчетов из ReportViewer.

Масштабирование страницы отчета

Панель инструментов ReportViewer поддерживает стандартные функции масштабирования, позволяя увеличить или уменьшить отчет. Серверный веб-элемент управления поддерживает масштабирование только в Internet Explorer.

Поиск в отчете

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

Экспорт отчета

Панель инструментов ReportViewer поддерживает форматы экспорта, позволяя пользователю сохранить отчет в поддерживаемом формате. Локальный отчет можно экспортировать в файл Excel, PDF или Word. Серверный отчет можно экспортировать в любой формат, поддерживаемый сервером отчетов. Если используется серверный веб-элемент управления, можно задать свойство ExportContentDisposition элемента управления, чтобы немедленно отобразить экспортированный отчет в средстве просмотра Excel или PDF, а не сохранять его в файл.

Один и тот же отчет может иметь разный вид и разный набор функций в зависимости от выбранного формата подготовки к просмотру. Отчеты, содержащие ссылки, схемы документов и закладки, могут работать неправильно после сохранения в файл. В зависимости от выравнивания элементов в отчете его макет в различных форматах файлов может содержать различное количество страниц или лишние пробелы. Дополнительные сведения см. в разделе Exporting Reports электронной документации по SQL Server.