Partilhar via


Coleções internas em expressões 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

Em uma expressão em um relatório paginado, você pode incluir referências às seguintes coleções internas: ReportItems, Parâmetros, Campos, DataSets, DataSources, Variáveis e campos internos para informações globais, como o nome do relatório. Nem todas as coleções são exibidas na caixa de diálogo Expressão. As coleções de DataSets e DataSources estão disponíveis apenas em tempo de execução para relatórios publicados em um servidor de relatório. A coleção de ReportItems é uma coleção de caixas de texto em uma região do relatório, por exemplo, as caixas de texto em uma página ou em um cabeçalho de página.

Para obter mais informações, confira Expressões (Construtor de Relatórios).

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.

Entenda as coleções internas

A tabela a seguir lista as coleções internas disponíveis quando você escreve uma expressão. Cada linha inclui o nome programático que diferencia maiúsculas de minúsculas para a coleção. O nome está lá se você puder usar a caixa de diálogo Expressão para adicionar uma referência interativamente à coleção, um exemplo e uma descrição que inclui quando os valores da coleção são inicializados e estão disponíveis para uso.

Coleção interna Categoria na caixa de diálogo Expressão Exemplo Descrição
Variáveis globais Campos internos =Globals.ReportName

- or -

=Globals.PageNumber
Representa variáveis globais úteis para relatórios, como o nome do relatório ou o número da página. Sempre disponível.

Para obter mais informações, confira Referências de usuários e globais internas (Construtor de Relatórios).
Usuário Campos internos =User.UserID

- ou -

=User.Language
Representa uma coleção de dados sobre o usuário que executa o relatório, como a configuração de idioma ou a ID de usuário. Sempre disponível.

Para obter mais informações, confira Referências de usuários e globais internas (Construtor de Relatórios).
Parâmetros Parâmetros =Parameters("ReportMonth").Value

- ou -

=Parameters!ReportYear.Value
Representa a coleção de parâmetros do relatório, cada um dos quais pode ter um valor único ou vários valores. Não disponível até que a inicialização do processamento seja executada. Para obter mais informações, confiraReferências de coleções de parâmetros (Construtor de Relatórios).
Campos( <Conjunto de dados> ) Fields =Fields!Sales.Value Representa a coleção de campos do conjunto de dados disponível para o relatório. Disponível depois que os dados são recuperados de uma fonte de dados em um conjunto de dados. Para obter mais informações, confira Referências de coleções de campos de conjuntos de dados (Construtor de Relatórios).
Conjuntos de Dados Não exibido =DataSets("TopEmployees").CommandText Representa a coleção de conjuntos de dados referidos no corpo de uma definição de relatório. Não inclui fontes de dados usadas apenas em cabeçalhos ou rodapés de páginas. Não disponível em visualização local. Para obter mais informações, consulte Referências de coleções DataSources e DataSets (Construtor de Relatórios).
DataSources Não exibido =DataSources("AdventureWorks2022").Type Representa a coleção de fontes de dados referidas de dentro do corpo de um relatório. Não inclui fontes de dados usadas apenas em cabeçalhos ou rodapés de páginas. Não disponível em visualização local. Para obter mais informações, consulte Referências de coleções DataSources e DataSets (Construtor de Relatórios).
Variáveis Variables =Variables!CustomTimeStamp.Value Representa a coleção de variáveis de relatório e variáveis de grupo. Para obter mais informações, confira Referências de coleções de variáveis de grupo e de relatório (Construtor de Relatórios).
ReportItems Não exibido =ReportItems("Textbox1").Value Representa a coleção de caixas de texto para um item de relatório. Essa coleção pode ser usada para resumir itens na página para inclusão em um cabeçalho ou rodapé de página. Para obter mais informações, confira Referências de coleções ReportItems (Construtor de Relatórios).

Usando sintaxe de coleção em uma expressão

Para fazer referência a uma coleção em uma expressão, use a sintaxe padrão do Microsoft Visual Basic para um item em uma coleção. A tabela a seguir mostra exemplos de sintaxe de coleção.

Sintaxe Exemplo
Collection!ObjectName.Property =Fields!Sales.Value
Collection!ObjectName("Property") =Fields!Sales("Value")
Collection("ObjectName").Property =Fields("Sales").Value
Collection("Member") =User("Language")
Collection.Member =User.Language