Configurando e usando a Barra de Ferramentas do ReportViewer

Artigo
08/17/2015

Você pode definir propriedades na janela Propriedades ou no código para configurar o controle ReportViewer e a barra de ferramentas do ReportViewer. Você pode remover ou desabilitar comandos específicos e definir valores que são usados para inicializar a barra de ferramentas. Para obter mais informações sobre as propriedades de controle de servidor ReportViewer Web, consulte Propriedades Microsoft.Reporting.WebForms.ReportViewer. Para obter mais informações sobre as propriedades de controle do Windows Forms, consulte Propriedades Microsoft.Reporting.WinForms.ReportViewer.

Barra de ferramentas do ReportViewer

O controle ReportViewer inclui uma barra de ferramentas que fornece navegação, pesquisa, exportação e a funcionalidade de impressão para que os usuários podem trabalhar com relatórios em um aplicativo implantado. Você pode definir propriedades na barra de ferramentas em tempo de design para controlar sua aparência e determinar a disponibilidade das opções de tempo de execução. Se você quiser uma implementação diferente da barra de ferramentas, você pode criar uma barra de ferramentas personalizada para substituir a barra de ferramentas padrão.

ReportViewerToolbar

Dica

Devido às diferenças em como os elementos de interface do usuário são renderizados em formato HTML e instrumentação de Design de gráficos (GDI), a barra de ferramentas relatório varia dependendo se você estiver usando o controle de servidor Web ou o controle Windows Forms.

Mapas de documentos

Um mapa do documento é uma área de navegação que contém uma lista de links que os usuários podem clicar para navegar para uma área específica do relatório. O mapa do documento é uma caixa de divisão recolhível no lado esquerdo da área de exibição de relatório (ou à direita em ambientes da direita para a esquerda). Nem todos os relatórios têm um mapa do documento; Você deve definir um na definição de relatório para exibi-lo no Visualizador de relatórios.

Navegar em um relatório

A barra de ferramentas do ReportViewer inclui uma variedade de funções de navegação de página. O usuário pode selecionar uma página específica ou navegar diretamente para a primeira ou última página. Páginas são determinadas por quebras de páginas que são definidas explicitamente na definição de relatório. Quebras de página também podem ser calculadas automaticamente, dependendo do formato de saída de relatório que está usando.

Como o controle ReportViewer do ASP.NET usa postbacks assíncronos para interatividade por padrão, o usuário não pode usar o navegador novamente botão, a menos que você defina o InteractivityPostBackMode propriedade AlwaysSynchronous.

Para navegar os relatórios detalhados, o usuário pode usar o para o relatório pai botão na barra de ferramentas ReportViewer ou o navegador novamente botão se você definir o InteractivityPostBackMode propriedade adequadamente. No entanto, é recomendável que você criar seu aplicativo com uma opção de navegação em mente para manter o estado da sessão consistente quando o usuário navega relatórios detalhados. Caso contrário, o usuário pode receber uma mensagem de erro "Chamada sem o relatório de detalhamento de volta" ao navegar os relatórios de detalhamento. Para ajudar a manter o usuário para uma opção de navegação, você pode:

Use o AlwaysAsynchronous modo e o conjunto ShowBackButton para true.
Use o AlwaysSynchronous ou SynchronousOnDrillthrough modo e o conjunto ShowBackButton para false. Isso limita o usuário para o navegador novamente botão. Observe que essa opção não se beneficia do servidor Web os recursos do controle AJAX.

Interromper e atualizar um relatório

No controle de servidor da Web, o usuário pode clicar a Cancelar link do indicador de status ocupado para cancelar o processamento do relatório. No controle Windows Forms, o usuário pode clicar a Parar na barra de ferramentas ReportViewer para cancelar o processamento do relatório. O usuário pode usar o atualizar botão para disparar a renderização de relatório.

Se o usuário clicar atualizar para um servidor de relatório, o servidor de relatório reprocessa o relatório com os dados mais recentes. Observe que os dados mais recentes depende das políticas de cache e de instantâneo definidas no relatório.

Se o usuário clicar atualizar para um relatório local, o comportamento pode ser diferente. Como processados localmente relatórios usam dados que são fornecidos pelo seu aplicativo, talvez seja necessário atualizar a fonte de dados durante operações de atualização, fornecendo um código que manipula o ReportViewer.ReportRefresh evento. Se você não tratar esse evento para o controle Windows Forms, clicando em atualizar .will atualizar o relatório com dados antigos em seu aplicativo. Para obter mais informações sobre o ReportViewer.ReportRefresh evento para o controle de servidor Web, consulte ReportRefresh. Para obter mais informações sobre a versão de controle do Windows Forms, consulte ReportRefresh.

Imprimir um relatório

Barra de ferramentas ReportViewer fornece suporte à impressão. Suporte à impressão é implementada diferente para cada versão do controle ReportViewer. Além disso, o controle de servidor Web só fornece suporte de impressão no Internet Explorer. Para obter mais informações, consulte Impressão de relatórios do ReportViewer.

Aplicar zoom à página do relatório

Barra de ferramentas ReportViewer fornece funcionalidade de zoom padrão para que você pode aumentar ou reduzir o relatório. O controle de servidor Web fornece apenas suporte zoom no Internet Explorer.

Pesquisar um relatório

A barra de ferramentas do ReportViewer inclui um campo de pesquisa para que você possa localizar um texto específico em um relatório. Procurar conteúdo no relatório digitando uma palavra ou frase que você deseja localizar. A pesquisa diferencia maiúsculas de minúsculas e começa na página atualmente exibida. Não há suporte para caracteres curinga e operadores de pesquisa booleana. Somente conteúdo visível é incluído em uma operação de pesquisa. Se o relatório usa mostra / ocultar funcionalidade, conteúdo oculto não é pesquisado. Para procurar ocorrências subseqüentes do mesmo valor, clique em próximo.

Exportando um relatório

Barra de ferramentas ReportViewer fornece formatos de exportação para que o usuário pode salvar um relatório em um formato com suporte. Um relatório local pode ser exportado para um arquivo do Excel, PDF ou Word. Um relatório do servidor pode ser exportado para qualquer formato que o servidor de relatórios oferece suporte. Se você estiver usando o controle de servidor Web, você pode definir o ExportContentDisposition propriedade no controle para exibir imediatamente o relatório exportado no Excel ou em um visualizador PDF em vez de salvá-lo como um arquivo.

O mesmo relatório pode ter uma aparência diferente e funcionalidade dependendo do formato de renderização que você selecionar. Relatórios que têm indicadores, mapas de documentos e links podem não funcionar corretamente quando o relatório é salvo em um arquivo. Dependendo de como você alinhar itens em um relatório, o layout do relatório em um formato de arquivo diferente pode incluir um número diferente de páginas ou de espaço em branco extra.