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 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 (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 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 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.
.gif "Observação") 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 Partes de Relatório (Construtor de Relatórios e SSRS) e Partes de Relatório no Designer 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!<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 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 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 consiste em uma lista de valores delimitada por vírgulas dos valores selecionados em um parâmetro de diversos valores. Você pode usar qualquer delimitador no segundo parâmetro para Unir. |
=”Report for: “ & JOIN(Parameters!<MultivalueParameterName>.Value," & “ ) |
Retorna String que é composta por uma lista de valores delimitada por vírgulas dos valores selecionados em um parâmetro de diversos valores, precedida por uma cadeia de texto que apresenta a lista de valores. |
Para obter mais informações sobre como usar parâmetros em um filtro, consulte Parâmetros de relatório (Construtor de Relatórios e SSRS).
Consulte também
Tarefas
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)
Referência
Coleções internas em expressões (Construtor de Relatórios e SSRS)
Conceitos
Expressões (Construtor de Relatórios e SSRS)
Filtros comumente usados (Construtor de Relatórios e SSRS)