Usando coleções internas em expressões (Reporting Services)

O Reporting Services fornece as seguintes coleções internas que podem ser referidas em uma expressão: ReportItems, Parameters, Fields, DataSets, DataSources, Variables 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 é a 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, consulte Compreendendo referências de expressão (Reporting Services).

Entendendo as coleções internas

A tabela a seguir lista as coleções internas disponíveis no Reporting Services. Cada linha inclui o nome programático que diferencia maiúsculas de minúsculas para a coleção, 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
Globals	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, consulte Usando referências a campos internos em expressões (Reporting Services).
User	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, consulte Usando referências a campos internos em expressões (Reporting Services).
Parameters	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, consulte Usando referências de coleções de parâmetros em expressões (Reporting Services).
Fields(<Dataset>)	Campos	=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, consulte Usando referências de coleções de campos de conjuntos de dados em expressões (Reporting Services).
DataSets	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 Usando referências a coleções de DataSources e DataSets em expressões (Reporting Services).
DataSources	Não exibido	=DataSources("AdventureWorks2008R2").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 Usando referências a coleções de DataSources e DataSets em expressões (Reporting Services).
Variables	Variables	=Variables!CustomTimeStamp.Value	Representa a coleção de variáveis de relatório e variáveis de grupo. Para obter mais informações, consulte Usando as referências do conjunto de variáveis de relatórios e grupos em expressões (Reporting Services).
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, consulte Usando referências de coleções de ReportItems em expressões (Reporting Services).

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 MicrosoftVisual 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

Consulte também

Tarefas

Como adicionar uma expressão (Reporting Services)

Referência

Exemplos de expressões (Reporting Services)

Conceitos

Noções básicas do Design do Relatório