Usando constantes em expressões (Reporting Services)

Artigo
10/18/2010

Uma constante consiste no texto literal ou texto que foi predefinido por um componente do Reporting Services. O processador de relatório tem acesso às constantes predefinidas, de modo que quando você as inclui em uma expressão, os valores que elas representam são substituídos na expressão antes de ela ser avaliada.

Texto literal

Em uma expressão, texto literal é o texto que está entre aspas duplas. Você também poderá digitar o texto diretamente em uma caixa de texto sem aspas duplas, se ele não fizer parte de uma expressão. Se o valor da caixa de texto não começar com um sinal de igual (=), o texto será tratado como texto literal. A tabela a seguir mostra vários exemplos de texto literal em uma expressão.

Constante	Texto de exibição	Texto de expressão
Execução do relatório em:	<<Expr>>	="Report run at: " & Globals!ExecutionTime
Ciclos da Adventure Works	Ciclos da Adventure Works	Ciclos da Adventure Works
[Texto de exibição entre colchetes]	\[Texto de exibição entre colchetes\]	[Texto de exibição entre colchetes]

Para obter mais informações, consulte Compreendendo expressões simples e complexas (Reporting Services).

Constantes RDL

É possível usar constantes definidas em linguagem RDL (Report Definition Language) em uma expressão. Na caixa de diálogo Expressão, as constantes são exibidas quando você cria uma expressão para uma propriedade de relatório que aceita apenas determinados valores válidos, também conhecidos como tipos enumerados. A tabela a seguir mostra dois exemplos.

Propriedade	Descrição	Valores
TextAlign	Valores válidos para alinhamento de texto em uma caixa de texto.	Geral, À Esquerda, Centralizado, À Direita
BorderStyle	Valores válidos para uma linha adicionada a um relatório.	Padrão, Nenhum, Pontilhado, Tracejado, Sólido, Duplo, TraçoPonto, TraçoPontoPonto

Constantes do Visual Basic

É possível usar constantes definidas na biblioteca de tempo de execução Visual Basic em uma expressão. A tabela a seguir mostra dois exemplos.

Constante	Descrição
vbCrLf	A constante do Visual Basic para um retorno de carro seguiu uma nova linha. Por exemplo, a expressão a seguir mostra o carimbo de data/hora do processamento de relatório e o usuário em duas linhas em uma caixa de texto única: =Globals!ExecutionTime & vbCrLf & User!UserID
DateInterval.Day	A constante do Visual Basic usada para designar a parte do dia de um valor de data e hora em uma chamada de função DatePart. Por exemplo, para a data de 10 de janeiro de 2008, a função a seguir retorna o número 10: =DatePart("d",Globals!ExecutionTime)

vbCrLf

A constante do Visual Basic para um retorno de carro seguiu uma nova linha.

Por exemplo, a expressão a seguir mostra o carimbo de data/hora do processamento de relatório e o usuário em duas linhas em uma caixa de texto única:

=Globals!ExecutionTime & vbCrLf & User!UserID

DateInterval.Day

A constante do Visual Basic usada para designar a parte do dia de um valor de data e hora em uma chamada de função DatePart. Por exemplo, para a data de 10 de janeiro de 2008, a função a seguir retorna o número 10:

=DatePart("d",Globals!ExecutionTime)

Constantes CLR

É possível usar constantes definidas nas classes CLR (Common Language Run-time) .NET Framework em uma expressão. A tabela a seguir mostra um exemplo de uma cor definida pelo sistema.

Constante	Descrição
MistyRose	Ao criar uma expressão para uma propriedade do relatório baseada na cor do plano de fundo, é possível especificar uma cor pelo nome. Os nomes válidos são listados na caixa de diálogo Expressão.