Compartilhar via


Adicionando e configurando os controles do ReportViewer

Você pode adicionar uma ou mais instâncias de um controle ReportViewer a um Windows Forms ou um aplicativo ASP.NET ao arrastar o controle da seção de relatório da caixa de ferramentas para uma página ou um formulário em seu aplicativo. Você pode usar um painel de marcas inteligentes e propriedades para configurar o controle e vincular o relatório. Você também pode escrever código para configurar o controle programaticamente.

O controle ReportViewer exibe um relatório por vez. Você pode combinar várias instâncias do controle no formulário ou página mesmo se você quiser ser capaz de exibir relatórios simultaneamente. Você também pode usar uma única instância do controle para hospedar relatórios um por vez. Para usar um único controle para mostrar uma sequência de relatórios, você deve escrever código que associa um relatório à instância do controle ReportViewer que você deseja usar.

Os controles ReportViewer funcionam no modo de processamento local ou no modo de processamento remoto.

No modo de processamento local, o controle abre uma definição de relatório, processa e renderiza o relatório na área de exibição. No modo de processamento local, você pode obter a definição de relatório de um arquivo. rdlc no sistema de arquivos, um fluxo ou um recurso inserido em seu aplicativo. Para obter mais informações, consulte ReportPath, LoadReportDefinition e ReportEmbeddedResource.

No modo de processamento remoto, o controle recupera um relatório totalmente processado de um servidor de relatório do Reporting Services. No modo de processamento remoto, todos os relatórios e processamento de dados processamento é executado no servidor de relatório. Modo de processamento remoto é normalmente usado para relatórios previamente publicados, mas você também pode usar o processamento remoto de uma definição de relatório que você fornecer usando um fluxo. Para obter mais informações, consulte LoadReportDefinition, ReportServerUrl e ReportPath.

Importante

Você não pode usar arquivos. rdlc no modo de processamento remoto.Modo de processamento remoto exige uma cópia licenciada do SQL Server 2008 ou posterior do Reporting Services.Processamento remoto se destina a dar suporte a organizações que têm um SQL Server Reporting Services servidor de relatório e usar esse servidor junto com os controles.Uma solução de servidor fornece melhor desempenho e escalabilidade e oferece recursos adicionais como assinaturas, cache, e relatórios mais formatos de saída.Para obter mais informações sobre o modo de processamento remoto, consulte Configurando o ReportViewer para processamento remoto e Implantar relatórios e controles do ReportViewer.

Como adicionar e configurar um controle ReportViewer

  1. Adicionar um formulário do Windows ou da Web para um .NET Framework projeto 3.5 ou 4.5.

  2. No modo de design gráfico, arraste o ReportViewer controle do relatórios grupo do Toolbox ao formulário da Web ou formulário do Windows. O controle inclui uma tarefas do ReportViewer painel de marcas inteligentes para que você possa selecionar imediatamente o relatório.

    O arquivo Web. config é atualizado automaticamente com o manipulador HTTP para o ReportViewer controle. Para obter mais informações, consulte Configurações de Web.config para ReportViewer.

    Dica

    Para usar o ReportViewer controle em um formulário da Web, você também deve adicionar uma ScriptManager controle para sua página.Do Toolbox janela, no extensões AJAX grupo, arraste um ScriptManager controle à superfície de design acima a ReportViewer controle.

  3. No tarefas do ReportViewer painel de marcas inteligentes, selecionadas tarefas para adicionar um relatório e configurar o controle. Especificar o relatório determina se o controle está configurado para processamento local ou remoto.

    • Clique em criar um novo relatório para iniciar o Assistente de relatório e criar um arquivo de definição (. rdlc) do relatório dentro de seu aplicativo. Você pode criar novos relatórios no seu aplicativo que são processados localmente no cliente. Para saber mais sobre como criar relatórios, consulte Criando arquivos de definição de relatório do cliente (.rdlc).

    • Use escolher relatório para selecionar uma definição de relatório existente. Você pode escolher um arquivo de definição (. rdlc) do relatório local que é definido no projeto ou você pode escolher relatório do servidor para selecionar um relatório é publicado em um SQL Server 2008 o servidor de relatório do Reporting Services.

      Selecionar um relatório de servidor configura o controle para o processamento remoto. Para selecionar um relatório do servidor, você deve saber a URL do servidor de relatório e o caminho para o relatório. Ao fazer referência a um relatório em um servidor de relatório no modo nativo, o caminho do relatório começa com uma barra (/). ao fazer referência a um relatório em um servidor de relatório no modo integrado do SharePoint, o caminho do relatório é uma URL totalmente qualificada. Por exemplo:

      Modo nativo: Adventureworks 2008 exemplo relatórios/empresa vendas 2008

      Modo integrado do SharePoint: http://MyServer/sites/MySite/MyLibrary/Adventureworks 2008 exemplo relatórios/vendas da empresa 2008.rdl

      Para executar o relatório, você deve ter permissão no servidor de relatório para acessar o relatório. Se você não souber o caminho de URL ou um relatório, consulte o administrador do servidor de relatório. Para obter mais informações sobre relatórios do servidor, consulte Configurando o ReportViewer para processamento remoto.

      Selecionar um arquivo de definição (. rdlc) de relatório existente configura o controle para o processamento local. Ao escolher um relatório, você deve escolher um arquivo. rdlc. Você não pode especificar um arquivo. RDL, mesmo se houver em seu projeto. Para obter mais informações, consulte Criando arquivos de definição de relatório do cliente (.rdlc).

    • Clique em encaixar no recipiente pai para expandir a superfície de exibição do controle ReportViewer para que ele usa todo o espaço disponível no formulário ou página. Essa opção está disponível com o controle Windows Forms.

    • Clique em reassociar fontes de dados atualizar associações de fonte de dados para tabelas de dados e objetos comerciais que são usados no relatório. Essa opção está disponível depois que você selecionar um relatório para o controle. Você precisa reassociar uma fonte de dados se você modificar uma fonte de dados de relatório ou se você modificar um item de relatório de associação de dados fora do ambiente de design do relatório gráfico (por exemplo, se você editar o XML diretamente).

  4. Selecione o ReportViewer controle e abra a propriedades janela.

  5. Definir propriedades de ReportViewer controle para determinar a visibilidade e a disponibilidade de áreas de exibição. Use a documentação de referência para aprender sobre cada propriedade. Para obter mais informações, consulte propriedades ReportViewer. Para saber mais sobre a barra de ferramentas do ReportViewer, consulte Configurando e usando a Barra de Ferramentas do ReportViewer.

  6. Criar ou implantar o aplicativo para visualizar o relatório dentro do formulário ou página.

Consulte também

Conceitos

Usando o Painel de marcações inteligentes de tarefas do ReportViewer

Criando arquivos de definição de relatório do cliente (.rdlc)

Configurando o ReportViewer para processamento local

Configurando o ReportViewer para processamento remoto

Servidor Web do ReportViewer e Controles do Windows Forms

Outros recursos

Exemplos e instruções passo a passo