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

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

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

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

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

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

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

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

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

Во время перехода по многостраничным отчетам в формате HTML можно использовать кнопку «Назад» в обозревателе. Если же в приложении не используется панель инструментов обозревателя, можно использовать кнопку «Назад» на панели инструментов ReportViewer. Обратите внимание, что по умолчанию кнопка «Назад» панели инструментов ReportViewer отключена. Если нужно использовать эту кнопку, включите свойство ShowBackButton элемента управления ReportViewer.

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

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

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

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

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

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

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

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

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

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

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

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

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

См. также

Понятия

Печать отчетов из ReportViewer
Серверный веб-элемент управления ReportViewer и соответствующий элемент управления Windows Forms
Настройка ReportViewer для локальной обработки
Настройка ReportViewer для удаленной обработки