Caixa de diálogo de expressões

Use the Expression dialog box to write Windows Server 2008 Visual Basic expressions for report item properties. Você pode usar expressões para definir várias propriedades, incluindo cor, fonte e bordas. Em tempo de execução, o processador de relatório avalia as expressões e substitui o resultado para o valor da propriedade.

Expressões podem ser simples ou complexa. Você pode digitar 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 o expressão caixa de diálogo. Para obter mais informações, consulte Understanding Simple and Complex Expressions (Reporting Services) nos Manuais Online do SQL Server.

Para abrir o expressão caixa de diálogo, clique em expressão (fx) botão nas caixas de diálogo ou selecione expressão no menu de atalho ou listas suspensas no painel Propriedades. Para obter mais informações, consulte Understanding Expressions in Reporting Services nos Manuais Online do SQL Server.

O expressão caixa de diálogo funciona com uma única expressão por vez.

O expressão caixa de diálogo inclui uma janela de código, árvore de categoria, itens de categoria, painel de descrição e painel de exemplo.

O expressão caixa de diálogo é contextual; os itens de categoria e as descrições são alterados em resposta à categoria da expressão que você está trabalhando. Ele oferece suporte ao IntelliSense, conclusões, exemplos de chamadas de função e cores de sintaxe para ajudá-lo a detectar erros de sintaxe.

Para obter mais informações, consulte How to: Add an Expression nos Manuais Online do SQL Server, Expression Examples in Reporting Services nos Manuais Online do SQL Server, e Using Parameters in Expressions nos Manuais Online do SQL Server.

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, Visual Basic funções da biblioteca de tempo de execução .NET Framework classes common language runtime e funções personalizadas. A lista a seguir descreve as categorias e os valores que você pode adicionar a uma expressão.

• Definir expressão para: <PropertyName>
  O nome da propriedade que você está definindo uma expressão. Você também pode definir essa propriedade, por nome, no painel Propriedades.

• Constantes
  Fornece uma lista de valores predefinidos válidos para essa propriedade para propriedades que são baseadas em constantes. Por exemplo, uma propriedade baseada em cor mostra nomes de cores válidos. Para uma propriedade que é um tipo de dados booleano, os valores são True e False.

  Nem todos os itens que dão suporte a expressões podem ser definidos como uma constante. Se uma propriedade não pode ser definida para um valor constante, o painel de descrição fornecerá essas informações.

• Campos internos
  Fornece uma lista dos itens na coleção global que você pode usar em uma expressão. Algumas coleções são suportadas apenas após o relatório é publicado no servidor. Para obter mais informações, consulte Using Global Collections in Expressions nos Manuais Online do SQL Server.

• Parâmetros
  Fornece uma lista de parâmetros de relatório.

• Campos ( <selected Dataset> )
  Exibe a lista de campos do conjunto de dados selecionado na categoria de conjuntos de dados. Clique duas vezes em um campo para copiar o campo para o expressão caixa.

• 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 Using Report and Group Variables Collections References in Expressions (Reporting Services) nos Manuais Online do SQL Server.

• Operadores
  Exibe os operadores que podem ser incluídas em uma manipulação de cadeia de caracteres ou de cálculo. Para obter mais informações, consulte Using Operators in Expressions (Reporting Services) nos Manuais Online do SQL Server.

• Funções comuns
  Exibe funções comuns, agrupadas por tipo. Quando você seleciona uma função no painel Item, uma descrição e exemplo aparecem.

  Funções comuns incluem relatório interno e funções de agregação, Visual Basic funções da biblioteca em tempo de execução, e .NET Framework classes common language runtime (CLR) no Math e Convert namespace. Você também pode adicionar referências a classes CLR e assemblies externos que não aparecem na lista de categorias. Para obter mais informações, consulte Using External Functions and Assemblies in Expressions nos Manuais Online do SQL Server.

Opções

• Janela de código
  Use a janela de código no painel superior para digitar uma expressão. Quando você abre o expressão caixa de diálogo, a janela de código contém a expressão. Você pode substituir ou revisar a expressão. Você pode 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. Passe o mouse sobre o texto sublinhado para ver a mensagem de erro.

  Quando você digita em termos de coleção global seguidos por um separador de pontuação, você verá uma lista suspensa de membros ou propriedades disponíveis. Na lista suspensa, você pode digitar os primeiros caracteres seguidos por uma tabulação para preencher automaticamente a seleção.

  Quando você digitar um nome da função seguido por um parêntese esquerdo, você verá uma dica de ferramenta que fornece informações sobre os parâmetros e valores de retorno da função.

• Categoria
  Exibe categorias de expressões. Escolhendo 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 as funções comuns e selecione as funções de agregação para exibir Avg, Counte outras funções no Item painel.

• 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 este item no ponto de inserção na janela de código.

• Valores
  Dependendo da categoria e o item selecionado, 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

Outros recursos

Referência da interface do usuário de designer de relatórios (Visual Studio)