Развертывание отчетов и элементов управления ReportViewer

Статья
07/31/2015

Отчеты и элементы управления ReportViewer можно свободно распространять в составе приложения. Требования к развертыванию могут сильно различаться в зависимости от типа элемента управления и типа обработки (локальная или удаленная), настроенного для отчета. В одном приложении можно развертывать локально обрабатываемые и удаленно обрабатываемые отчеты.

Распространение элементов управления ReportViewer

Распространяемый файл элемента управления ReportViewer является самораскрывающимся. Он имеет имя ReportViewer.exe, и в его состав входят MSI-файлы и другие файлы. Файл ReportViewer.exe можно загрузить из центра загрузки Майкрософт.

Примечание

На одном компьютере можно устанавливать различные версии распространяемого пакета элемента управления ReportViewer.

После запуска файла ReportViewer.exe в папку глобального кэша сборок на компьютере развертывания устанавливаются следующие файлы.

Microsoft.ReportViewer.Common.dll
Microsoft.ReportViewer.ProcessingObjectModel.dll
Microsoft.ReportViewer.WebForms.dll
Microsoft.ReportViewer.WinForms.dll
Microsoft.ReportViewer.DataVisualization.dll

Запуск файла ReportViewer.exe

Используемый тип элемента управления определяет место, где следует запускать файл ReportViewer.exe.

Для приложений ASP.NET файл ReportViewer.exe запускается на веб-сервере, где размещается приложение. Это действие должен выполнять администратор сервера.
Для приложений Windows Forms ClickOnce следует включить элементы управления в список обязательных компонентов приложения, чтобы автоматически устанавливать их вместе с приложением ClickOnce. Для автоматизации этого шага можно использовать приложение начальной загрузки.
1. Откройте страницу свойств проекта.
2. Перейдите на вкладку Опубликовать и нажмите кнопку Необходимые компоненты.
3. Выберите пункты Средство просмотра отчетов Microsoft Visual Studio и Типы CLR SQL Server, а затем нажмите кнопку ОК.
4. Убедитесь, что установлен флажок в поле Загрузить необходимые компоненты с веб-сайта поставщика компонентов. Это единственный поддерживаемый параметр. Затем нажмите кнопку ОК.
5. Нажмите кнопку Параметры.
6. На вкладке Развертывание укажите веб-страницу развертывания и установите флажок в поле Автоматически создавать веб-страницу развертывания после каждой публикации.
7. Нажмите кнопку ОК и опубликуйте приложение.
При обращении к приложению ClickOnce, например с веб-страницы, выполняется проверка наличия на клиентском компьютере необходимых компонентов ReportViewer. Если они не установлены, то будут установлены программой установки.

Развертывание локализованных версий элементов управления ReportViewer

Распространяемый пакет элемента управления ReportViewer локализован на десять языков Visual Studio: китайский (упрощенное письмо), китайский (традиционное письмо), французский, немецкий, итальянский, японский, корейский, португальский (Бразилия), русский и испанский. Если установлена локализованная версия Visual Studio, то можно загрузить любой локализованный распространяемый пакет ReportViewer из центра загрузки Майкрософт.

Чтобы использовать в элементе управления ReportViewer другие языки, можно реализовать интерфейс IreportViewerMessages3 или IreportViewerMessages3 для создания подсказок и другого текста пользовательского интерфейса на определенном языке.

Определение языка и региональных параметров браузера

Если серверный веб-элемент управления ReportViewer используется для размещения отчетов в приложении браузера, необходимо указать региональные параметры потока, если нужно обеспечить пользовательский интерфейс, язык и региональные параметры которого согласованы с браузером. ASP.NET не устанавливает региональные параметры потока на основании данных заголовка, передаваемых клиентом. Чтобы региональные параметры приложения совпадали с браузером, можно задать свойства Thread.CurrentCulture и Thread.CurrentUICulture в коде приложения. Дополнительные сведения о работе с региональными параметрами в приложении см. в разделе System.Globalization.CultureInfo.

Вопросы развертывания для серверного веб-элемента управления ReportViewer

Для развертывания приложения ASP.NET в веб-ферме необходима дополнительная настройка, чтобы обеспечить сохранение состояния просмотра в пределах фермы. Если серверный веб-элемент управления ReportViewer развертывается в среде веб-фермы, следует указать элемент machineKey в файле Web.config приложения. Дополнительные сведения см. в разделе Параметры файла web.config для ReportViewer.

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

Распространение файлов отчета

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

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