Partilhar via

Caixa de diálogo Expressão

  • Artigo

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.

Uma expressão pode ser simples ou complexa. É possível inserir expressões simples diretamente em uma caixa de texto na superfície de design ou em uma caixa de diálogo. Para criar expressões complexas, use a caixa de diálogo Expressão. Você pode criar uma expressão de cada vez. Para obter mais informações, consulte Expressões (Construtor de Relatórios e SSRS).

Para abrir a caixa de diálogo Expressão, clique no botão Expressão (fx) nas caixas de diálogo ou selecione Expressão no menu de atalho ou nas listas suspensas do painel Propriedades. Para obter mais informações, consulte Uso de expressões em relatórios (Construtor de Relatórios e SSRS).

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 é contextual. Os itens e descrições de categoria são alterados de acordo com a categoria da expressão com a qual você está trabalhando. Ela oferece suporte ao IntelliSense, conclusões de instruções, exemplos de chamada de função e cores de sintaxe para ajudar a detectar erros de sintaxe.

Construções de expressão

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 Referências globais internas e referências de usuários (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.

Consulte também

Tarefas

Adicionar uma expressão (Construtor de Relatórios e SSRS)

Referência

Exemplos de expressões (Construtor de Relatórios e SSRS)

Coleções internas em expressões (Construtor de Relatórios e SSRS)

Conceitos

Expressões (Construtor de Relatórios e SSRS)

Uso de expressões em relatórios (Construtor de Relatórios e SSRS)

Formatando números e datas (Construtor de Relatórios e SSRS)

Referências de coleções de parâmetros (Construtor de Relatórios e SSRS)

Exemplos de expressões de grupo (Construtor de Relatórios e SSRS)

Exemplos de equações de filtro (Construtor de Relatórios e SSRS)

Tipos de dados em expressões (Construtor de Relatórios e SSRS)