Método WorksheetFunction.Lookup (Excel)

  • Artigo

Retorna um valor de um intervalo de uma linha ou uma coluna ou de uma matriz. A função Pesquisa tem duas formas de sintaxe: o formulário de vetor e o formulário de matriz.

Sintaxe

expressão. Pesquisa (Arg1, Arg2, Arg3)

Expressão Uma variável que representa um objeto WorksheetFunction .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Arg1 Obrigatório Variantes Lookup_value – um valor que a Pesquisa pesquisa no primeiro vetor. Valor_procurado pode ser número, texto, valor lógico ou um nome ou uma referência que indica um valor.
Arg2 Obrigatório Variantes Lookup_vector ou Matriz – Em forma de vetor, um intervalo que contém apenas uma linha ou uma coluna. Os valores de vetor_procurado podem ser texto, números ou valores lógicos. No formato de matriz, um intervalo de células que contenha texto, números ou valores lógicos a serem comparados com valor_procurado.
Arg3 Opcional Variantes Result_vector – usado apenas com o formulário de vetor. Um intervalo que contém somente uma linha ou coluna. Deve ter o mesmo tamanho que o vetor_proc.

Valor de retorno

Variant

Comentários

Se você desejar Consulte Uso
Examinar um intervalo de uma linha ou uma coluna (conhecido como vetor) em busca de um valor e retornar um valor da mesma posição em um segundo intervalo de uma linha ou uma coluna. Formato de vetor Use o formato de vetor quando tiver uma lista grande de valores para procurar ou quando os valores puderem mudar ao longo do tempo.
Examinar a primeira linha ou coluna de uma matriz em busca do valor especificado e retornar um valor da mesma posição na última linha ou coluna da matriz. Formato de matriz Use o formato de matriz quando tiver uma pequena lista de valores e eles se mantiverem constantes ao longo do tempo.

Forma vetorial

Um vetor é um intervalo de apenas uma linha ou uma coluna. A forma vetor de Pesquisa procura em um intervalo de uma linha ou de uma coluna (conhecido como vetor) para um valor e retorna um valor da mesma posição em um segundo intervalo de uma linha ou de uma coluna. Use esta forma da função Pesquisa quando quiser especificar o intervalo que contém os valores que você deseja corresponder. A outra forma de Pesquisa é olhada automaticamente na primeira coluna ou linha.

Importante

Os valores em lookup_vector devem ser colocados em ordem crescente: ...,-2, -1, 0, 1, 2, ..., A-Z, FALSE, TRUE; caso contrário, a Pesquisa pode não fornecer o valor correto. Os textos em maiúsculas e em minúsculas são equivalentes.

Se a Pesquisa não encontrar o lookup_value, ele corresponderá ao maior valor em lookup_vector menor ou igual a lookup_value.

Se lookup_value for menor que o menor valor em lookup_vector, a Pesquisa fornecerá o valor de erro #N/A.

Forma matricial

A forma de matriz de Pesquisa procura na primeira linha ou coluna de uma matriz para o valor especificado e retorna um valor da mesma posição na última linha ou coluna da matriz. Use esta forma de Pesquisa quando os valores que você deseja corresponder estiverem na primeira linha ou coluna da matriz. Use a outra forma de Pesquisa quando quiser especificar o local da coluna ou linha.

Dica

Em geral, é melhor usar a função HLookup ou VLookup em vez da forma de matriz de Pesquisa. Essa forma de Pesquisa é fornecida para compatibilidade com outros programas de planilha.

  • Se a Pesquisa não conseguir encontrar o lookup_value, ela usará o maior valor da matriz que é menor ou igual a lookup_value.

  • Se lookup_value for menor que o menor valor na primeira linha ou coluna (dependendo das dimensões da matriz), a Pesquisa retornará o valor de erro #N/A.

A forma de matriz de Pesquisa é muito semelhante às funções HLookup e VLookup . A diferença é que o HLookup pesquisa lookup_value na primeira linha, pesquisas de VLookup na primeira coluna e pesquisas de pesquisa de acordo com as dimensões da matriz.

  • Se a matriz abrange uma área mais ampla do que alta (mais colunas do que linhas), a pesquisa procurará lookup_value na primeira linha.

  • Se a matriz for quadrada ou for mais alta do que larga (mais linhas do que colunas), pesquise pesquisa na primeira coluna.

  • Com HLookup e VLookup, você pode indexar para baixo ou para baixo, mas a Pesquisa sempre seleciona o último valor na linha ou coluna.

Importante

Os valores na matriz devem ser colocados em ordem crescente: ...,-2, -1, 0, 1, 2, ..., A-Z, FALSE, TRUE; caso contrário, a Pesquisa pode não fornecer o valor correto. Os textos em maiúsculas e em minúsculas são equivalentes.

Observação

Você também pode usar a função Pesquisa como alternativa à função IF para testes ou testes elaborados para mais de sete condições. Veja os exemplos no formato de matriz.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.