Implantar relatórios e controles do ReportViewer

Artigo
06/10/2015

Você pode distribuir livremente relatórios e os controles ReportViewer como parte do seu aplicativo. Requisitos de implantação variam muito, dependendo do tipo de controle e se o relatório estiver configurado para processamento local ou remoto. Você pode implantar relatórios processados localmente e remotamente processados no mesmo aplicativo.

Redistribuindo controles do ReportViewer

O controle ReportViewer redistribuível é um arquivo de extração automática chamado ReportViewer.exe que inclui um arquivo. msi e outros arquivos. Você pode baixar ReportViewer.exe do Microsoft Download Center.

Dica

Versões diferentes do controle ReportViewer redistribuível podem ser instaladas no mesmo computador.

Quando você executa ReportViewer.exe, os seguintes arquivos são instalados na pasta de Cache de Assembly Global no computador de implantação.

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

Executando ReportViewer.exe

O tipo de controle que você está usando determina onde ReportViewer.exe deve ser executado.

Para aplicativos ASP.NET, execute ReportViewer.exe no servidor Web que hospeda o aplicativo. Isso deve ser feito por um administrador de servidor.
Para aplicativos do Windows Forms ClickOnce, incluem os controles como um pré-requisito de aplicativo para que eles são instalados automaticamente com o seu aplicativo ClickOnce. Você pode usar o aplicativo de inicialização para automatizar a etapa:
1. Abra a página de propriedades do projeto.
2. Clique o publicar guia e, em seguida, clique no pré-requisitos botão.
3. Selecione Visualizador de relatórios do Microsoft Visual Studio, e tipos CLR SQL Server , em seguida, clique em OK.
4. Verifique se o baixar pré-requisitos da opção do site do fornecedor do componente é verificada. Essa é a única opção com suporte. Em seguida, clique em OK.
5. Clique o opções botão.
6. No implantação , especifique uma página da Web de implantação e selecione o gerar automaticamente a página da web de implantação após a publicação já caixa de seleção.
7. Clique em OK e publicar o aplicativo.
Quando você acessa um aplicativo ClickOnce, como por meio de uma página da Web, uma verificação é executada no computador cliente para verificar se os pré-requisitos do ReportViewer já estão instalados. Se eles não estiverem instalados, o programa de instalação irá instalá-lo.

Implantar versões localizadas de controles ReportViewer

O controle ReportViewer redistribuível está localizado em dez idiomas do Visual Studio: chinês simplificado, chinês tradicional, francês, alemão, italiano, japonês, coreano, português (Brasil), russo e espanhol. Se você instalar uma versão localizada do Visual Studio, você pode baixar qualquer ReportViewer localizada redistribuível do Microsoft Download Center.

Para usar em outros idiomas um ReportViewer controle, você pode implementar a IreportViewerMessages3 ou IreportViewerMessages3 interface para criar as dicas de ferramentas e outros textos de interface do usuário em um idioma específico.

Detecção de idioma do navegador e configurações de cultura

Se você estiver usando o controle de servidor ReportViewer Web para hospedar relatórios em um aplicativo de navegador, certifique-se de definir a cultura do thread para fornecer uma interface de usuário que corresponde às configurações de idioma e cultura do navegador. ASP.NET não define a cultura do thread com base nas informações de cabeçalho fornecidas pelo cliente. Para corresponder a seu aplicativo para as configurações de cultura do navegador, você pode definir Thread.CurrentCulture e Thread.CurrentUICulture no código do aplicativo. Para obter mais informações sobre como trabalhar com configurações de cultura em seu aplicativo, consulte CultureInfo.

Considerações de implantação para o controle de servidor de Web de Visualizador de relatório

Implantando um aplicativo ASP.NET em um Web farm requer configuração adicional para garantir que o estado de exibição é mantido no farm. Se você estiver implantando o controle ReportViewer Web server em um ambiente de farm da Web, você deve especificar o machineKey elemento no arquivo Web. config de seu aplicativo. Para obter mais informações, consulte Configurações de Web.config para ReportViewer.

Relatórios que são processados no controle de servidor ReportViewer Web têm diversos requisitos de navegador. Problemas de compatibilidade do navegador podem afetar a disponibilidade de alguns tipos de funcionalidade de relatório. Para obter mais informações, consulte Procurar suporte para os controles do servidor Web do ReportViewer.

Distribuição de arquivos de relatório

A menos que você está gerando dinamicamente definição de relatório de cliente em tempo de execução usando o LocalReport.LoadReportDefinition ou ServerReport.LoadReportDefinition método, você tem algumas opções diferentes para distribuir os arquivos de relatório com seu aplicativo, dependendo do modo de processamento do controle do Visualizador de relatórios.

Relatórios que são processados localmente podem ser armazenados em uma pasta de rede ou compilados no executável do aplicativo. Relatórios que são processados em um servidor remoto normalmente são armazenados em um SQL Server o servidor de relatório do Reporting Services. A menos que você deseja usar o ServerReport.LoadReportDefinition método para carregar manualmente um relatório de um local diferente do servidor de relatório, não há nenhum arquivo de relatório para incluir em seu aplicativo. Para implantar relatórios publicados em um servidor de relatório, você deve fornecer acesso contínuo a um servidor de relatório e garantir que esse aplicativo, os usuários estão autorizados a exibir os relatórios no servidor. Implantar relatórios de servidor requer uma compreensão da extensão de autenticação usado pelo servidor de relatório e o modelo de autorização baseada em função que fornece acesso a conteúdos e operações. Para obter mais informações, consulte Considerações de implantação de relatórios de servidor.