Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Aplica-se a:
Construtor de Relatórios da Microsoft (SSRS) Designer de Relatórios do Power BI 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, Parameters, Fields, DataSets, DataSources, Variables e campos internos para informações globais, como o nome do relatório. Nem todas as coleções aparecem no diálogo Expressão . As coleções DataSets e DataSources estão disponíveis apenas em tempo de execução para relatórios publicados num servidor de relatórios. A coleção ReportItems é uma coleção de caixas de texto em uma região de relatório, por exemplo, as caixas de texto em uma página ou em um cabeçalho de página.
Para mais informações, consulte 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, no Construtor de Relatórios do Power BI e no Designer de Relatórios no SQL Server Data Tools.
Compreender as coleções incorporadas
A tabela a seguir lista as coleções internas disponíveis quando você escreve uma expressão. Cada linha inclui o nome de programação sensível a maiúsculas e minúsculas para a coleção. O nome está lá se pode usar o diálogo Expression para adicionar interativamente uma referência à coleção, um exemplo, e uma descrição que inclua quando os valores da coleção estão inicializados e disponíveis para uso.
| Coleção Built-in | Categoria na caixa de diálogo Expressão | Example | Description |
|---|---|---|---|
| Globais | Campos Incorporados | =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 mais informações, consulte Globais incorporados e referências de utilizadores (Construtor de Relatórios). |
| User | Campos Incorporados | =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 do usuário. Sempre disponível. Para mais informações, consulte Globais incorporados e referências de utilizadores (Construtor de Relatórios). |
| Parâmetros | Parâmetros | =Parameters("ReportMonth").Value- ou - =Parameters!ReportYear.Value |
Representa a coleção de parâmetros de relatório, cada um dos quais pode ser de valor único ou multivalor. Não disponível até que a inicialização do processamento esteja concluída. Para mais informações, consulte Referências da coleção de parâmetros (Construtor de Relatórios). |
| Campos(<Conjunto de>dados ) | Campos | =Fields!Sales.Value |
Representa a coleção de campos do conjunto de dados que estão disponíveis para o relatório. Disponível depois que os dados são recuperados de uma fonte de dados para um conjunto de dados. Para mais informações, consulte Referências da coleção de campos de conjunto de dados (Construtor de Relatórios). |
| Conjuntos de dados | Não exibido | =DataSets("TopEmployees").CommandText |
Representa a coleção de conjuntos de dados referenciados do corpo de uma definição de relatório. Não inclui fontes de dados usadas apenas em cabeçalhos ou rodapés de página. Não disponível na pré-visualização local. Para mais informações, consulte referências às coleções DataSources e dataSets (Construtor de Relatórios). |
| Fontes de dados | Não exibido | =DataSources("AdventureWorks2022").Type |
Representa a coleta de fontes de dados referenciadas no corpo de um relatório. Não inclui fontes de dados usadas apenas em cabeçalhos ou rodapés de página. Não disponível na pré-visualização local. Para mais informações, consulte referências da coleção 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 mais informações, consulte Referências às coleções de Relatório e variáveis agrupadas (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. Esta coleção pode ser usada para resumir itens na página para inclusão em um cabeçalho ou rodapé de página. Para mais informações, consulte as referências da coleção ReportItems (Construtor de Relatórios). |
Usando a sintaxe da coleção em uma expressão
Para se referir a uma coleção de 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 | Example |
|---|---|
| Coleção! ObjectName.Property | =Fields!Sales.Value |
| Coleção! ObjectName("Propriedade") | =Fields!Sales("Value") |
| Collection("ObjectName"). Propriedade | =Fields("Sales").Value |
| Coleção("Membro") | =User("Language") |
| Collection.Member | =User.Language |