Usando expressões (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 itens 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. Este tópico contém exemplos dos muitos lugares em que você pode usar expressões para variar o conteúdo ou a aparência de um relatório. Esta lista não é completa. Você pode definir uma expressão para qualquer propriedade em uma caixa de diálogo que exiba o botão de expressão (fx) ou em uma lista suspensa que exiba <Expressão...>.
As expressões são gravadas no MicrosoftVisual Basic. Uma expressão começa com um sinal de igual (=) seguido por uma combinação de referências a coleções internas, como campos de conjunto de dados e parâmetros, constantes, funções e operadores.
Usando expressões simples
As expressões simples contêm uma referência a um único campo de conjunto de dados, parâmetro ou campo interno. As expressões simples aparecem na superfície de design e em caixas de diálogo entre colchetes; por exemplo, um campo de conjunto de dados é exibido como [ProductID]. As expressões simples são criadas automaticamente quando você arrasta um campo de um conjunto de dados até uma caixa de texto. É criado um espaço reservado, e a expressão define o valor subjacente. Você também pode digitar expressões diretamente em uma célula da região de dados ou em uma caixa de texto, ambas na superfície de design ou em uma caixa de diálogo (por exemplo, [ProductID]).
A tabela a seguir lista exemplos de como usar expressões simples. A tabela descreve a funcionalidade, a propriedade a ser definida, a caixa de diálogo que você costuma usar para defini-la e o valor da propriedade. É possível digitar a expressão simples diretamente na superfície de design, em uma caixa de diálogo ou no painel Propriedades, ou ainda editá-la na caixa de diálogo Expressão, exatamente como você faria com qualquer expressão.
Funcionalidade |
Propriedade, contexto e caixa de diálogo |
Valor da propriedade |
|---|---|---|
Especifique um campo de conjunto de dados a ser exibido em uma caixa de texto. |
A propriedade Value de um espaço reservado dentro de uma caixa de texto. Use a Caixa de diálogo Propriedades do Espaço Reservado, Geral. |
[Sales] |
Agregue valores de um grupo. |
A propriedade Value de um espaço reservado dentro de uma caixa de texto. Use a Caixa de diálogo Propriedades da Caixa de Texto, Geral. |
[Sum(Sales)] |
Inclua um número de página. |
A propriedade Value de um espaço reservado dentro de uma caixa de texto que é colocada em um cabeçalho de página. Use a Caixa de diálogo Propriedades da Caixa de Texto, Geral. |
[&PageNumber] |
Exiba um valor de parâmetro selecionado. |
A propriedade Value de um espaço reservado dentro de uma caixa de texto na superfície de design. Use a Caixa de diálogo Propriedades da Caixa de Texto, Geral. |
[@SalesThreshold] |
Especifique uma definição de grupo para uma região de dados. |
Expressão de grupo no grupo Tablix. Use a Caixa de diálogo Propriedades do Grupo Tablix, Geral. |
[Category] |
Exclua de uma tabela um valor de campo específico. |
Equação de filtro no Tablix. Use a Caixa de diálogo Propriedades do Tablix, Filtros. |
Para tipo de dados, selecione Inteiro. [Quantity] > 100 |
Inclua somente um valor específico para um filtro de grupo. |
Equação de filtro no grupo Tablix. Use a Caixa de diálogo Propriedades do Grupo Tablix, Filtros. |
[Category] = Clothing |
Exclua de um conjunto de dados valores específicos de mais de um campo. |
Equação de filtro para um grupo em um Tablix. Use a Caixa de diálogo Propriedades do Tablix, Filtros. |
=[Color] <> Red =[Color] <> Blue |
Especifique a ordem de classificação com base em um campo existente em uma tabela. |
Expressão de classificação no Tablix. Use a Caixa de diálogo Propriedades do Tablix, Classificação. |
[SizeSortOrder] |
Vincule um parâmetro de consulta a um parâmetro de relatório. |
Coleção de parâmetros no conjunto de dados. Use a Caixa de diálogo Propriedades do Conjunto de Dados, Parâmetros. |
[@Category] [@Category] |
Passe um parâmetro de um relatório principal para um sub-relatório. |
Coleção de parâmetros no sub-relatório. Use a Caixa de diálogo Propriedades do Sub-relatório, Parâmetros. |
[@Category] [@Category] |
Para ver mais exemplos, consulte Exemplos de expressões (Reporting Services).
Usando expressões complexas
As expressões complexas podem conter várias referências internas, operadores e chamadas de função e são exibidas na superfície de design como <<Expr>>. Para ver ou alterar o texto da expressão, abra a caixa de diálogo Expressão ou digite diretamente no painel Propriedades. A tabela a seguir lista maneiras comuns de usar uma expressão complexa para exibir ou organizar dados ou alterar a aparência de um relatório, inclusive a propriedade a ser definida, a caixa de diálogo que você costuma usar para defini-la e o valor da propriedade. Você pode digitar uma expressão diretamente em uma caixa de diálogo, na superfície de design ou no painel Propriedades.
Funcionalidade |
Propriedade, contexto e caixa de diálogo |
Valor da propriedade |
|---|---|---|
Calcule valores agregados para um conjunto de dados. |
A propriedade Value de um espaço reservado dentro de uma caixa de texto. Use a Caixa de diálogo Propriedades do Espaço Reservado, Geral. |
=First(Fields!Sales.Value,"DataSet1") |
Concatene texto e expressões na mesma caixa de texto. |
A propriedade Value de um espaço reservado dentro de uma caixa de texto que é colocada em um cabeçalho ou rodapé de página. Use a Caixa de diálogo Propriedades do Tablix, Filtros. |
="This report began processing at " & Globals!ExecutionTime |
Calcule um valor agregado para um conjunto de dados em outro escopo. |
Value de um espaço reservado dentro de uma caixa de texto que é colocada em um grupo Tablix. Use a Caixa de diálogo Propriedades do Tablix, Filtros. |
=Max(Fields!Total.Value,"DataSet2) |
Formate os dados de uma caixa de texto de acordo com o valor. |
Color de um espaço reservado dentro de uma caixa de texto na linha de detalhes de um Tablix. Use a Caixa de diálogo Propriedades da Caixa de Texto, Fonte. |
=IIF(Fields!TotalDue.Value < 10000,"Red","Black") |
Calcule um valor uma única vez para fazer referência a ele em todo o relatório. |
Value de uma variável de relatório. Use a Caixa de diálogo Propriedades do Relatório, Variáveis. Para obter mais informações sobre variáveis, consulte Usando as referências do conjunto de variáveis de relatórios e grupos em expressões (Reporting Services). |
=Variables!MyCalculation.Value |
Inclua valores específicos de mais de um campo de um conjunto de dados. |
Equação de filtro para um grupo em um Tablix. Use a Caixa de diálogo Propriedades do Tablix, Filtros. |
Para tipo de dados, selecione Booleano. =IIF(InStr(Fields!Subcat.Value,"Shorts")=0 AND (Fields!Size.Value="M" OR Fields!Size.Value="S"),TRUE, FALSE) = TRUE |
Oculte uma caixa de texto na superfície de design que pode ser alternada pelo usuário através de um parâmetro booleano denominado Show. |
Hiddenpropriedade em uma caixa de texto. Use a Caixa de diálogo Propriedades da Caixa de Texto, Visibilidade. |
=Not Parameters!Show<boolean parameter>.Value |
Especifique um cabeçalho de página dinâmico ou o conteúdo de um rodapé. |
Value de um espaço reservado dentro de uma caixa de texto que é colocada no cabeçalho ou rodapé de uma página. Use a Caixa de diálogo Propriedades do Tablix, Filtros. |
="Page " & Globals!PageNumber & " of " & Globals!TotalPages |
Especifique uma fonte de dados dinamicamente usando um parâmetro. |
Cadeia de conexão na fonte de dados. Use a Caixa de diálogo Propriedades da Fonte de Dados, Geral. |
="Data Source=" & Parameters!ServerName.Value & ";initial catalog=AdventureWorks" |
Identifique todos os valores para um parâmetro multivalor escolhido pelo usuário. |
Value de um espaço reservado dentro de uma caixa de texto. Use a Caixa de diálogo Propriedades do Tablix, Filtros. |
=Join(Parameters!MyMultivalueParameter.Value,", ") |
Especifique quebras de página para cada 20 linhas de um Tablix sem outros grupos. |
Expressão de grupo para um grupo em um Tablix. Use a Caixa de diálogo Propriedades do Grupo Tablix, Geral. PageBreak para o grupo no Tablix. Use a Caixa de diálogo Propriedades do Grupo Tablix, Quebras de Página. Defina Entre cada instância de um grupo. |
=Ceiling(RowNumber(Nothing)/20) |
Especifique a visibilidade condicional com base em um parâmetro. |
A propriedade Hidden de um Tablix. Use a Caixa de diálogo Propriedades do Tablix, Visibilidade. |
=Not Parameters!<boolean parameter>.Value |
Especifique uma data formatada para uma determinada cultura. |
Value de um espaço reservado dentro de uma caixa de texto em uma região de dados. Use a Caixa de diálogo Propriedades da Caixa de Texto, Geral. |
=Fields!OrderDate.Value.ToString(System.Globalization.CultureInfo.CreateSpecificCulture("de-DE")) |
Concatene uma cadeia de caracteres e um número formatado como porcentagem com duas casas decimais. |
Value de um espaço reservado dentro de uma caixa de texto em uma região de dados. Use a Caixa de diálogo Propriedades da Caixa de Texto, Geral. |
="Growth Percent: " & Format(Fields!Growth.Value,"p2") |
Para ver mais exemplos, consulte Exemplos de expressões (Reporting Services).
Consulte também