Compartilhar via


Referências da coleção de ReportItems em um relatório paginado (Construtor de Relatórios)

Aplica-se a: Microsoft Report Builder (SSRS) Power BI Report Builder Report Designer no SQL Server Data Tools

A coleção interna ReportItems é o conjunto de caixas de texto de itens de relatório, como linhas de uma região de dados ou caixas de texto na superfície de design do relatório paginado. A coleção de ReportItems inclui caixas de texto que estão no escopo atual de um cabeçalho de página, rodapé de página ou corpo de relatório. Essa coleção é determinada em tempo de execução pelo processador de relatório e pelo renderizador de relatório. O escopo atual é alterado conforme o processador de relatório combina dados de relatório e os elementos de layout do item de relatório sucessivamente conforme o usuário exibe páginas de um relatório. É possível usar a coleção interna de ReportItems para produzir cabeçalhos de páginas em estilo de dicionário que mostram o primeiro e o último item em cada página.

Observação

Você pode criar e modificar arquivos de definição de relatório paginado (.rdl) no Construtor de Relatórios da Microsoft, Construtor de Relatórios do Power BI e no Designer de Relatórios no SQL Server Data Tools.

Usar a propriedade Value de ReportItems

Itens na coleção ReportItems têm apenas uma propriedade: Value. O valor para um item de ReportItems pode ser usado para exibir ou calcular dados de outro campo no relatório. Para acessar o valor da caixa de texto atual, é possível usar o Me.Value ou simplesmente o Value global interno do Visual Basic. Em funções de relatório, como First e funções de agregação, use a sintaxe totalmente qualificada.

Por exemplo:

  • Esta expressão, colocada em uma caixa de texto, exibe o valor de uma caixa de texto de um ReportItem denominado Textbox1:

    =ReportItems!Textbox1.Value

  • Essa expressão, colocada em uma propriedade Color da caixa de texto ReportItem, exibe o texto em preto quando o valor é > 0. Caso contrário, o valor é exibido em vermelho:

    =IIF(Me.Value > 0,"Black","Red")

  • Essa expressão, colocada em uma caixa de texto no cabeçalho ou no rodapé da página, exibe o primeiro valor por página do relatório renderizado, para uma caixa de texto denominada LastName:

    =First(ReportItems("LastName").Value)

Expressões de cabeçalho de página em estilo de dicionário

É possível criar um cabeçalho de página para exibir o primeiro e o último cliente na página. Como a caixa de texto no cabeçalho da página pode referir-se apenas à coleção interna ReportItems uma vez em uma expressão, é necessário adicionar duas caixas de texto ao cabeçalho da página: uma para o nome do primeiro cliente (=First(ReportItems!textboxLastName.Value) e uma para o nome do último cliente (=Last(ReportItems!textboxLastName.Value).

Em uma seção do cabeçalho ou rodapé de página, apenas as caixas de texto na página atual estão disponíveis como um membro da coleção ReportItems . Por exemplo, se o ReportItems!textboxLastName.Value se referir a uma caixa de texto exibida apenas na primeira página de uma região de dados de várias páginas, você verá um valor para a primeira página, mas todas as outras páginas exibirão o #Erro para mostrar que não foi possível avaliar a expressão como foi gravada.

Escopo para a coleção ReportItems

Conforme o relatório é processado, cada caixa de texto no corpo do relatório ou em uma região de dados é avaliada no contexto de seu conjunto de dados, região de dados e associações de grupos. O escopo para um referência à coleção ReportItems é o escopo atual ou qualquer ponto superior ao escopo atual.

Por exemplo, uma caixa de texto em uma linha que está em um grupo pai não deve conter uma expressão que faça referência ao nome de uma caixa de texto em uma linha do grupo filho. Essa expressão não é resolvida como um valor no relatório porque a caixa de texto da linha filho está fora do escopo. Para obter mais informações, consulte Referência de funções agregadas (Construtor de Relatórios).