• Artigo

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

Os parâmetros de relatório são uma das coleções internas que você pode referenciar 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 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ões (Report Builder 3.0 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 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 3.0 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 vários valores ou um valor único.

ObservaçãoObservação

É possível criar e modificar definições de relatórios (.rdl) no Report Builder 3.0 e no Designer de Relatórios no Business Intelligence Development Studio. Cada ambiente de criação fornece diferentes maneiras de criar, abrir e salvar relatórios e itens relacionados. Para obter mais informações, consulte Projetando e implementando relatórios usando o Designer de Relatórios (Reporting Services) 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!<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 para 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 Adicionando filtros de conjunto de dados, filtros de região de dados e filtros de grupo (Construtor de Relatórios 3.0 e SSRS).

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 Parâmetros (Report Builder 3.0 e SSRS).