Função de pesquisa (Construtor de Relatórios e SSRS)

Retorna o primeiro valor correspondente para o nome especificado de um conjunto de dados que contém pares nome/valor.

Sintaxe

  
Lookup(source_expression, destination_expression, result_expression, dataset)  

Parâmetros

source_expression
(Variant) Uma expressão que é avaliada no escopo atual e que especifica o nome ou a chave a ser pesquisada. Por exemplo, =Fields!ProdID.Value.

destination_expression
(Variant) Uma expressão que é avaliada para cada linha em um conjunto de dados e que especifica o nome ou a chave para correspondência. Por exemplo, =Fields!ProductID.Value.

result_expression
(Variant) Uma expressão avaliada para a linha no conjunto de dados em que source_expression = destination_expression e que especifica o valor a ser recuperado. Por exemplo, =Fields!ProductName.Value.

conjunto de dados
Uma constante que especifica o nome do conjunto de dados no relatório. Por exemplo, "Produtos".

Retorno

Retorna um Variant ou Nothing se não houver correspondência.

Observações

Use Lookup para recuperar o valor do conjunto de dados especificado para um par de nome/valor em que há uma relação de 1 a 1. Por exemplo, para um campo de ID em uma tabela, você pode usar Lookup para recuperar o campo Nome correspondente de um conjunto de dados que não está associado à região de dados.

Lookup faz o seguinte:

• Avalia a expressão de origem no escopo atual.

• Avalia a expressão de destino para cada linha do conjunto de dados especificado depois que foram aplicados filtros, com base na ordenação do conjunto de dados especificado.

• Na primeira correspondência da expressão de origem e destino, avalia a expressão resultante para aquela linha no conjunto de dados.

• Retorna o valor da expressão resultante.

Para recuperar vários valores para um único nome ou campo de chave em que há uma relação de 1 para muitos, use a Função LookupSet (Construtor de Relatórios e SSRS). Para chamar Lookup um conjunto de valores, use a Função Multilookup (Construtor de Relatórios e SSRS).

Veja as restrições abaixo:

• Lookup é avaliado depois que todas as expressões de filtro são aplicadas.

• Só um nível de pesquisa tem suporte. Uma expressão de origem, destino ou resultado não pode incluir uma referência a uma função de pesquisa.

• Expressões de origem e destino devem ser avaliadas como o mesmo tipo de dados. O tipo de retorno é o mesmo que o tipo de dados da expressão resultante avaliada.

• Expressões de origem, destino e resultado não podem incluir referências a variáveis de relatório ou grupo.

• Lookup não pode ser usado como uma expressão para os seguintes itens de relatório:

  • Cadeias de conexão dinâmicas para uma fonte de dados.

  • Campos calculados em um conjunto de dados.

  • Parâmetros de consulta em um conjunto de dados.

  • Filtros em um conjunto de dados.

  • Parâmetros de relatório.

  • A propriedade Report.Language.

Para obter mais informações, confira Referência de funções de agregação (Construtor de Relatórios e SSRS) e Escopo das expressões para totais, agregações e coleções internas (Construtor de Relatórios e SSRS).

Exemplo

No exemplo a seguir, suponha que uma tabela esteja associada a um conjunto de dados que inclui um campo para o ProductID do identificador de produto. Um conjunto de dados separado chamado "Produto" contém a ID do identificador de produto correspondente e o nome do produto.

Na expressão a seguir, Lookup compara o valor de ProductID à ID em cada linha do conjunto de dados chamado "Produto" e, quando uma correspondência é encontrada, retorna o valor do campo Nome dessa linha.

=Lookup(Fields!ProductID.Value, Fields!ID.Value, Fields!Name.Value, "Product")  

Consulte Também

Uso de expressões em relatórios (Construtor de Relatórios e SSRS)
Exemplos de expressões (Construtor de Relatórios e SSRS)
Tipos de dados em expressões (Construtor de Relatórios e SSRS)
Escopo das expressões para totais, agregações e coleções internas (Construtor de Relatórios e SSRS)