Referências de coleções de parâmetros (Construtor de Relatórios e SSRS)

Os parâmetros de relatório são umas das coleções internas que você pode fazer referência a partir 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 e SSRS).

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 e SSRS).

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 diversos valores ou um valor único.

Observação

Você pode criar e modificar definições de relatório (.rdl) no Construtor de Relatórios e no Designer de Relatórios no SQL Server Data Tools. Cada ambiente de criação fornece modos diferentes para criar, abrir e salvar relatórios e itens relacionados. Para obter mais informações, consulte Criando relatórios no Designer de Relatórios e no Construtor de Relatórios (SSRS) na Web em microsoft.com.

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!<Nome do> parâmetro .IsMultiValue	Retorna False. Verifica se um parâmetro é de diversos valores. Se True, o parâmetro é multivalor e é uma coleção de objetos. Se False, o parâmetro é de valor único e é um único objeto.
=Parameters!<Nome do> parâmetro .Count	Retorna um valor inteiro 1. Para um parâmetro de valor único, a contagem é sempre 1.
=Parameters!<Nome do> parâmetro .Label	Retorna o rótulo do parâmetro, geralmente usado como o nome para exibição em uma lista suspensa de valores disponíveis.
=Parameters!<Nome do> parâmetro .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! <Nome do> parâmetro .Value)	Retorna o valor de parâmetro como uma cadeia de caracteres.
=Fields(Parameters!<Nome do> parâmetro .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 e SSRS).

Usando um parâmetro de diversos 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 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 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).

Consulte Também

Expressões (Construtor de Relatórios e SSRS)
Filtros comumente usados (Construtor de Relatórios e SSRS)
Adicionar, alterar ou excluir um parâmetro de relatório (Construtor de Relatórios e SSRS)
Tutorial: Adicionar um parâmetro ao relatório (Construtor de Relatórios)
Tutoriais (Construtor de Relatórios)
Coleções internas em expressões (Construtor de Relatórios e SSRS)