Compreendendo expressões simples e complexas (Reporting Services)

No Reporting Services, as expressões são usadas em toda a definição de relatório para especificar ou calcular valores para parâmetros, consultas, filtros, propriedades de item de relatório, definições de classificação e grupo, propriedades de caixa de texto, indicadores, mapas do documento, conteúdo de cabeçalho e rodapé de página dinâmica, imagens e definições de fonte de dados dinâmica.

As expressões começam com o sinal de igualdade (=) e são formuladas no MicrosoftVisual Basic. Elas podem incluir uma combinação de constantes, operadores e referências para valores internos (campos, coleções e funções) e para código externo ou personalizado.

As expressões podem ser de um dos dois tipos a seguir:

  • Simples   Uma expressão que tem uma referência simples a um item em uma coleção interna, como, por exemplo, um campo do conjunto de dados, um parâmetro ou um campo interno. As expressões simples aparecem na superfície de design em caixas de diálogo entre colchetes, como [FieldName], que representa a expressão subjacente =Fields!FieldName.Value. Você pode digitar expressões simples diretamente em uma caixa de texto na superfície de design e o texto da expressão correspondente será definido como o valor de um espaço reservado dentro da caixa de texto. Para obter mais informações, consulte Formatando texto e importando HTML.

  • Complexa   Uma expressão que inclui mais de uma referência simples. As expressões complexas aparecem na superfície de design como <<Expr>>. As expressões complexas podem ser criadas na caixa de diálogo Expressão ou digitadas diretamente no painel Propriedade. Para obter mais informações sobre o que pode ser incluído em uma expressão, consulte Compreendendo referências de expressão (Reporting Services).

As expressões simples podem ser definidas automaticamente arrastando os itens, como, por exemplo, os campos de conjunto de dados, para a superfície de design. Para definir as expressões manualmente, selecione um item na superfície de design e use os menus de atalho e as caixas de diálogo para definir as propriedades do item. Quando você visualizar o botão (fx) ou o valor <Expression> na lista suspensa, poderá definir a propriedade para uma expressão.

Para obter mais informações, consulte Usando expressões (Reporting Services).

Compreendendo o texto de exibição das expressões

As expressões simples usam símbolos para indicar se a referência destina-se a um campo, um parâmetro, uma coleção interna ou à coleção ReportItems. A tabela a seguir mostra exemplos de textos de expressão e de exibição.

Item

Exemplo de texto de exibição

Exemplo de texto de expressão

Campos de conjunto de dados

[Sales]

[SUM(Sales)]

[FIRST(Store)]

=Fields!Sales.Value

=Sum(Fields!Sales.Value)

=First(Fields!Store.Value)

Parâmetros de relatório

[@Param]

[@Param.Label]

=Parameters!Param.Value

=Parameters!Param.Label

Campos internos

[&ReportName]

=Globals!ReportName.Value

Caracteres literais usados no texto de exibição

\[Sales\]

[Sales]

Expressões complexas

<<Expr>>

="Page " & Globals!PageNumber & " of " & Globals!TotalPages