Развертывание отчетов и элементов управления ReportViewer
Отчеты и элементы управления ReportViewer можно свободно распространять в составе приложения. Требования к развертыванию могут сильно различаться в зависимости от типа элемента управления и типа обработки (локальная или удаленная), настроенного для отчета. В одном приложении можно развертывать локально обрабатываемые и удаленно обрабатываемые отчеты.
Распространение элементов управления ReportViewer
Распространяемый файл элемента управления ReportViewer является самораскрывающимся. Он имеет имя ReportViewer.exe, и в его состав входят MSI-файлы и другие файлы. Файл ReportViewer.exe находится по следующему пути: C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0\BootStrapper\Packages\ReportViewer\ReportViewer.exe.
После запуска файла ReportViewer.exe в папку глобального кэша сборок на компьютере развертывания копируются следующие файлы.
| Файл | Описание |
|---|---|
Microsoft.ReportViewer.Common |
Обеспечивает базовые функции работы с отчетом, общие для элемента управления Windows Forms ReportViewer и серверного веб-элемента управления. |
Microsoft.ReportViewer.ProcessingObjectModel |
Делает модель объектов отчета доступной программным образом из выражений в определении отчета во время выполнения. |
Microsoft.ReportViewer.WebForms |
Предоставляет элемент управления ReportViewer для страниц ASP.NET. |
Microsoft.ReportViewer.WinForms |
Предоставляет элемент управления ReportViewer для приложений Windows. |
Запуск файла ReportViewer.exe
Используемый тип элемента управления определяет место, где следует запускать файл ReportViewer.exe.
Для приложений ASP.NET файл ReportViewer.exe запускается на веб-сервере, где размещается приложение.
Для приложений Windows Forms следует включить элементы управления в список обязательных компонентов приложения, чтобы они автоматически устанавливались вместе с приложением. Для автоматизации этого шага можно использовать приложение начальной загрузки.
Откройте страницу свойств проекта.
Нажмите кнопку Опубликовать, а затем нажмите кнопку Требования.
Выберите пункт Microsoft Visual Studio 2008 Report Viewer и нажмите кнопку ОК.
Опубликуйте приложение.
Во время установки приложения на локальном компьютере будет проверяться, установлен ли элемент управления ReportViewer. Если он не установлен, программа установки установит его.
Развертывание локализованных версий элементов управления ReportViewer
Элемент управления ReportViewer включает языковые пакеты для десяти языков Visual Studio: китайский (упрощенный), китайский (традиционный), французский, немецкий, итальянский, японский, корейский, португальский (бразильский), русский и испанский. Для использования локализованной версии элемента управления нужно выполнить следующие действия.
Запустите файл ReportViewer.exe.
Перейдите к папке, содержащей нужный языковой пакет. Путь к папкам языковых пакетов имеет вид <диск>:\Program Files\Microsoft SDKs\Windows\v6.0A\BootStrapper\Packages\ReportViewer\<язык>.
Запустите файл ReportViewerLP.exe.
Чтобы использовать в элементе управления ReportViewer другие языки, можно реализовать интерфейс Microsoft.Reporting.WebForms.IReportViewerMessages или Microsoft.Reporting.WinForms.IReportViewerMessages для создания подсказок и другого текста пользовательского интерфейса на определенном языке.
Определение языка и региональных параметров обозревателя
Если серверный веб-элемент управления ReportViewer используется для размещения отчетов в приложении обозревателя, необходимо указать региональные параметры потока, если нужно обеспечить пользовательский интерфейс, язык и региональные параметры которого согласованы с обозревателем. ASP.NET не устанавливает региональные параметры потока на основании данных заголовка, передаваемых клиентом. Чтобы региональные параметры приложения совпадали с обозревателем, можно задать свойства System.Threading.Thread.CurrentCulture и System.Threading.Thread.CurrentUICulture в коде приложения. Дополнительные сведения о работе с региональными параметрами в приложении см. в разделе System.Globalization.CultureInfo.
Вопросы развертывания для серверного веб-элемента управления ReportViewer
Для развертывания приложения ASP.NET в веб-ферме необходима дополнительная настройка, чтобы обеспечить сохранение состояния просмотра в пределах фермы. Если серверный веб-элемент управления ReportViewer развертывается в среде веб-фермы, следует указать элемент machineKey в файле Web.config приложения. Дополнительные сведения см. в разделе Параметры файла web.config для ReportViewer.
Отчеты, обрабатываемые в серверном веб-элементе управления ReportViewer, имеют различные требования к обозревателю. Проблемы совместимости с обозревателем могут повлиять на доступность некоторых функций отчета. Дополнительные сведения см. в разделе Поддержка обозревателей для серверных веб-элементов управления ReportViewer.
Распространение отчетов
За исключением случаев, когда RDLC-файлы создаются динамически во время выполнения, локально обрабатываемые отчеты хранятся в файловой системе в виде RDLC-файлов, и их необходимо включать в поставку приложения. Файлы можно устанавливать с диска или включить в исполняемый файл приложения.
Отчеты, обрабатываемые на удаленном сервере, хранятся на сервере отчетов служб Microsoft SQL Server 2005 Reporting Services. В приложение не включаются файлы отчета, поскольку отчеты обрабатываются удаленно и не существуют в локальной системе. Для развертывания отчетов, опубликованных на сервере отчетов, необходимо обеспечить постоянный доступ к серверу отчетов и убедиться, что пользователи приложения имеют разрешение на просмотр отчетов на этом сервере. Для развертывания серверных отчетов необходимо знать, какой модуль проверки подлинности используется на сервере отчетов и какая модель ролевой авторизации обеспечивает доступ к содержимому и операциям. Дополнительные сведения см. в разделе Вопросы развертывания серверных отчетов.
См. также
Понятия
Добавление и настройка элементов управления ReportViewer
Параметры файла web.config для ReportViewer
Настройка ReportViewer для асинхронной подготовки отчетов
Настройка и использование панели инструментов ReportViewer