Caixa de diálogo Expressão
Use a caixa de diálogo Expressão para escrever expressões do Microsoft Visual Basic para propriedades de item 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, confira 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 Usos de expressão 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õ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 de biblioteca de tempo de execução do Visual Basic, classes de tempo de execução de linguagem comum 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, confira Referências de 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( <conjunto de dados> selecionado )
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 .
Conjunto 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, confira 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 funções internas de relatório e agregação, funções de biblioteca de tempo de execução do Visual Basic e CLR (Common Language Runtime Classes) do .NET Framework no Math namespace 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, confira 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 para um valor de caixa de texto, expanda Funções comuns e selecione Agregar funções para exibir Avg, Counte 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.
Confira também
Expressões (Construtor de Relatórios e SSRS)
Exemplos de 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)
Coleções internas em expressões (Construtor de Relatórios e SSRS)
Adicionar uma expressão (Construtor de Relatórios e SSRS)