Caixa de diálogo Expressão (Construtor de Relatórios 2.0)
Use a caixa de diálogo Expressão para escrever expressões do MicrosoftVisual 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.
As expressões podem ser simples ou complexas. É 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. Para obter mais informações, consulte Compreendendo expressões simples e complexas (Construtor de Relatórios 2.0).
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 Compreendendo expressões simples e complexas (Construtor de Relatórios 2.0).
Algumas caixas de diálogo (por exemplo, Caixa de diálogo Propriedades do Conjunto de Dados, Filtros (Construtor de Relatórios 2.0)) permitem criar várias expressões combinadas durante o processamento do relatório, mas a caixa de diálogo Expressão funciona com uma única expressão de cada vez.
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. 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.
Para obter mais informações, consulte Como adicionar uma expressão (Construtor de Relatórios 2.0), Exemplos de expressão (Construtor de Relatórios 2.0) e Usando referências de coleções de parâmetros em expressões (Construtor de Relatórios 2.0).
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 booleano, 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 Usando coleções internas em expressões (Construtor de Relatórios 2.0).Parâmetros
Fornece uma lista de parâmetros de relatório.Campos(<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 Usando referências de coleções de variáveis de grupo e de relatório em expressões (Construtor de Relatórios 2.0).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 Usando operadores em expressões (Construtor de Relatórios 2.0).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 Usando função comum e referências ao assembly (Construtor de Relatórios 2.0).
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 para esse item na 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