Caixa de diálogo Expressão (Construtor de Relatórios)

Artigo
09/10/2013

Use a caixa de diálogo Expressão para escrever expressões do Microsoft Visual Basic para propriedades de itens de relatório. É possível usar expressões para definir muitas propriedades, incluindo cor, fonte e bordas. Em tempo de execução, o processador de relatório avalia as expressões e substitui o resultado do valor da propriedade.

A caixa de diálogo Expressão inclui uma janela de código, uma árvore de categoria, itens de categoria, um painel de descrição e um painel de exemplo. A caixa de diálogo Expressão é sensível ao contexto. Os itens e descrições de categoria são alterados em resposta à categoria da expressão com a qual você está trabalhando. Para obter mais informações, consulte Exemplos de expressões (Construtor de Relatórios e SSRS) e Expressões (Construtor de Relatórios e SSRS).

Construções de expressões

As expressões começam com um sinal de igual (=) e podem incluir constantes, literais, operadores e referências a campos internos, coleções internas, funções internas, funções da biblioteca em tempo de execução do Visual Basic, classes do common language runtime do .NET Framework e funções personalizadas. A lista a seguir descreve as categorias e os valores que podem ser adicionados a uma expressão.

Definir expressão para: <PropertyName>
O nome da propriedade para a qual você está definindo uma expressão. Também é possível definir essa propriedade por nome, no painel Propriedades.
Constantes
Fornece uma lista de valores predefinidos válidos para essa propriedade para propriedades baseadas em constantes. Por exemplo, uma propriedade baseada em cor mostra nomes de cores válidos. Para uma propriedade do tipo de dados booliano, os valores são True e False.

Nem todos os itens que oferecem suporte às expressões podem ser definidos como uma constante. Se uma propriedade não puder ser definida como valor de constante, o painel de descrição fornecerá essas informações.
Campos internos
Fornece uma lista de itens na coleção global que podem ser usados em uma expressão. Algumas coleções recebem suporte somente após a publicação do relatório no servidor. Para obter mais informações, consulte Coleções internas em expressões (Construtor de Relatórios e SSRS).
Parâmetros
Fornece uma lista de parâmetros de relatório.
Fields( <selected Dataset> )
Exibe a lista de campos para o conjunto de dados selecionado na categoria Conjuntos de dados. Clique duas vezes em um campo para copiá-lo na caixa Expressão.
Conjuntos de dados
Fornece uma lista de conjuntos de dados disponíveis e mostra os campos que são membros do conjunto de dados.
Variáveis
Exibe uma lista de variáveis de relatório. Para obter mais informações, consulte Referências de coleções de variáveis de grupo e de relatório (Construtor de Relatórios e SSRS).
Operadores
Exibe os operadores que podem ser incluídos em uma manipulação de cálculo ou de cadeia de caracteres. Para obter mais informações, consulte Operadores em expressões (Construtor de Relatórios e SSRS).
Funções comuns
Exibe funções comuns, agrupadas por tipo. Ao selecionar uma função no painel Item, uma descrição e exemplo são exibidos.

As funções comuns incluem relatório interno e funções de agregação, funções da biblioteca de tempo de execução do Visual Basic e classes CLR (common language runtime) do .NET Framework nos namespaces Math e Convert. Também é possível adicionar referências às classes CLR e aos assemblies externos que não são exibidos na lista de categorias. Para obter mais informações, consulte Referências a código personalizado e assemblies em expressões no Designer de Relatórios (SSRS).

Opções

Janela de código
Use a janela de código no painel superior para digitar uma expressão. Ao abrir a caixa de diálogo Expressão, a janela de código contém a expressão. É possível substituir ou revisar a expressão. É possível adicionar chamadas de função, operadores, constantes, campos, parâmetros, itens das coleções globais e referências ao código personalizado. A janela de código exibe as alterações conforme elas são feitas.

Um sublinhado vermelho ondulado indica um erro de sintaxe. Focalize o texto sublinhado para ver a mensagem de erro.

Ao digitar os termos da coleção global seguidos por um separador de pontuação, você vê uma lista suspensa de membros ou propriedades disponíveis. Na lista suspensa, digite os primeiros caracteres seguidos por um caractere de tabulação para preencher automaticamente a seleção.

Ao digitar o nome de uma função seguido por um parênteses à esquerda, você vê uma dica de ferramenta que fornece informações sobre os parâmetros e os valores de retorno da função.
Categoria
Exibe categorias de expressões. A escolha de uma categoria estabelece um contexto para a criação de uma expressão e altera a lista de valores válidos no painel Item. Por exemplo, para uma expressão de um valor da caixa de texto, expanda as funções Comuns e selecione as funções de Agregação para exibir a Avg, Count e outras funções no painel Item.
Item
Exibe a lista de valores válidos para a categoria selecionada. Clique duas vezes em um item para adicionar o texto da expressão a esse item no ponto de inserção da janela de código.
Valores
Dependendo da categoria e do item selecionados, o terceiro painel conterá uma descrição, uma expressão de exemplo ou uma lista de valores válidos. Arraste a borda da caixa de diálogo para alargar a área de exemplo.