WorksheetFunction.Lookup(Object, Object, Object) Método

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

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

public object Lookup (object Arg1, object Arg2, object Arg3);

Public Function Lookup (Arg1 As Object, Arg2 As Object, Optional Arg3 As Object) As Object

Parâmetros

Arg1

Object

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

Object

Vetor_proc ou matriz - no formato 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

Object

Vetor_result - usado apenas no formato de vetor. Um intervalo que contém somente uma linha ou coluna. Deve ter o mesmo tamanho que o vetor_proc.

Retornos

Object

Comentários

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.

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.

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 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 essa 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. Textos em letras maiúsculas e minúsculas são equivalentes.

Se PROC não localizar o valor_procurado, ele buscará o maior valor de vetor_proc que seja menor que ou igual ao valor_procurado.

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 HLookup(Object, Object, Object, Object)função ou VLookup(Object, Object, Object, Object)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 localizar o lookup_value, ela usará o maior valor na 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 HLookup(Object, Object, Object, Object) funções e VLookup(Object, Object, Object, Object) . A diferença é que HLookup(Object, Object, Object, Object) pesquisa lookup_value na primeira linha, VLookup(Object, Object, Object, Object) pesquisa na primeira coluna e pesquisa 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 ampla (mais linhas do que colunas), pesquisará na primeira coluna.

Com HLookup(Object, Object, Object, Object) e VLookup(Object, Object, Object, Object), 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.