Usando referências de coleções de parâmetros em expressões (Construtor de Relatórios 2.0)
Os parâmetros de relatório são uma das coleções internas que você pode referenciar em uma expressão. Incluindo parâmetros em uma expressão, é possível personalizar os dados e a aparência do relatório com base nas opções feitas por um usuário. As expressões podem ser usadas para qualquer propriedade de item de relatório ou propriedade de caixa de texto que forneça a opção (Fx) ou <Expressão>. As expressões também são usadas para controlar o conteúdo e a aparência do relatório de outras maneiras. Para obter mais informações, consulte Exemplos de expressão (Construtor de Relatórios 2.0).
Quando você compara os valores do parâmetro com os valores do campo do conjunto de dados em tempo de execução, os tipos de dados para os dois itens que você está comparando devem ser os mesmos. Os parâmetros de relatório podem ser de um dos seguintes tipos: Boolean, DateTime, Integer, Float, ou Text, que representa a String de tipo de dados subjacentes. Se necessário, você pode precisar converter o tipo de dados do valor do parâmetro para corresponder ao valor do conjunto de dados. Para obter mais informações, consulte Trabalhando com tipos de dados em expressões (Construtor de Relatórios 2.0).
Para incluir uma referência de parâmetro em uma expressão, você deve entender como especificar a sintaxe correta para a referência de parâmetro que varia, dependendo de se o parâmetro tem vários valores ou um valor único.
Usando um parâmetro de valor único em uma expressão
A tabela a seguir mostra exemplos da sintaxe a ser usada ao incluir uma referência a um parâmetro de valor único de qualquer tipo de dados em uma expressão.
Exemplo |
Descrição |
|---|---|
=Parameters!<ParameterName>.IsMultiValue |
Retorna False. Verifica se um parâmetro é de vários valores. Se for True, o parâmetro é de vários valores e é uma coleção de objetos. Se for False, o parâmetro é de valor único e é um único objeto. |
=Parameters!<ParameterName>.Count |
Retorna um valor inteiro 1. Para um parâmetro de valor único, a contagem é sempre 1. |
=Parameters!<ParameterName>.Label |
Retorna o rótulo do parâmetro, geralmente usado como o nome de exibição em uma lista suspensa de valores disponíveis. |
=Parameters!<ParameterName>.Value |
Retorna o valor de parâmetro. Se a propriedade Label não tiver sido definida, este valor será exibido na lista suspensa de valores disponíveis. |
=CStr(Parameters! <ParameterName>.Value) |
Retorna o valor de parâmetro como uma cadeia de caracteres. |
=Fields(Parameters!<ParameterName>.Value).Value |
Retorna o valor para o campo que tem o mesmo nome do parâmetro. |
Para obter mais informações sobre como usar parâmetros em um filtro, consulte Filtrando os dados de relatório no relatório (Construtor de Relatórios 2.0).
Usando um parâmetro de vários valores em uma expressão
A tabela a seguir mostra exemplos da sintaxe a ser usada ao incluir uma referência a um parâmetro de vários valores de qualquer tipo de dados em uma expressão.
Exemplo |
Descrição |
|---|---|
=Parameters!<MultivalueParameterName>.IsMultiValue |
Retorna True ou False. Verifica se um parâmetro é de vários valores. Se for True, o parâmetro é de vários valores e é uma coleção de objetos. Se for False, o parâmetro é de valor único e é um único objeto. |
=Parameters!<MultivalueParameterName>.Count |
Retorna um valor inteiro. Refere-se ao número de valores. Para um parâmetro de valor único, a contagem é sempre 1. Para um parâmetro de vários valores, a contagem é 0 ou mais. |
=Parameters!<MultivalueParameterName>.Value(0) |
Retorna o primeiro valor em um parâmetro de vários valores. |
=Parameters!<MultivalueParameterName>.Value(Parameters!<MultivalueParameterName>.Count-1) |
Retorna o último valor em um parâmetro de vários valores. |
=Split("Value1,Value2,Value3",",") |
Retorna uma matriz de valores. Crie uma matriz de valores para um parâmetro String de vários valores. Você pode usar qualquer delimitador no segundo parâmetro para Divisão. Esta expressão pode ser usada para definir padrões para um parâmetro de vários valores ou para criar um parâmetro de vários valores para ser enviado a um sub-relatório ou relatório de detalhamento. |
=Join(Parameters!<MultivalueParameterName>.Value,", ") |
Retorna String que é composta por uma lista de valores delimitada por vírgulas em um parâmetro de vários valores. Você pode usar qualquer delimitador no segundo parâmetro para Unir. |
Para obter mais informações sobre como usar parâmetros em um filtro, consulte Filtrando os dados de relatório no relatório (Construtor de Relatórios 2.0).
Consulte também