Referências da coleção de parâmetros em um relatório paginado (Construtor de Relatórios)

  • Artigo

Aplica-se a: Microsoft Report Builder (SSRS) Power BI Report Builder Report Designer no SQL Server Data Tools

Os parâmetros dos relatório paginados são umas das coleções internas que você pode fazer referência por meio de 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 fornece a opção (*Fx) ou <Expression>. 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, confira Exemplos de expressões (Construtor de Relatórios).

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 o tipo de dados String subjacente. 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, confira Tipos de dados em expressões (Construtor de Relatórios).

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. A sintaxe varia dependendo se o parâmetro é um parâmetro de valor único ou de vários valores.

Observação

Você pode criar e modificar arquivos de definição de relatório paginado (.rdl) no Construtor de Relatórios da Microsoft, Construtor de Relatórios do Power BI e no Designer de Relatórios no SQL Server Data Tools.

Usar 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 diversos valores. Se for True, o parâmetro é de diversos valores e é uma coleção de objetos. Se 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 para exibição em uma lista 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 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, confira Adicionar filtros de conjunto de dados, de região de dados e de grupo (Construtor de Relatórios).

Usar 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 diversos 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 diversos valores. Se for True, o parâmetro é de diversos valores e é uma coleção de objetos. Se 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 diversos valores, a contagem é 0 ou mais.
=Parameters! <MultivalueParameterName> .Value(0) Retorna o primeiro valor em um parâmetro de diversos valores.
=Parameters! <MultivalueParameterName> .Value(Parameters! <MultivalueParameterName> .Count-1) Retorna o último valor em um parâmetro de diversos valores.
=Split("Value1,Value2,Value3",",") Retorna uma matriz de valores.

Crie uma matriz de valores para um parâmetro String de diversos 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 diversos valores ou para criar um parâmetro de diversos valores para ser enviado a um sub-relatório ou relatório detalhado.
=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, confira Parâmetros de relatório (Construtor de Relatórios e Designer de Relatórios).

Conteúdo relacionado