Método WorksheetFunction.VLookup (Excel)

Procura um valor na primeira coluna de uma matriz de tabela e retorna um valor na mesma linha de outra coluna da matriz da tabela.

Sintaxe

expressão. VLookup (Arg1, Arg2, Arg3, Arg4)

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

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Arg1	Obrigatório	Variant	Lookup_value - o valor a ser pesquisado na primeira coluna da matriz de tabela. Lookup_value pode ser um valor ou uma referência. Se lookup_value for menor que o menor valor na primeira coluna de table_array, o VLookup retornará o valor de erro #N/A.
Arg2	Obrigatório	Variant	Table_array - duas ou mais colunas de dados. Use uma referência para um intervalo ou um nome do intervalo. Os valores da primeira coluna da table_array são os valores pesquisados por lookup_value. Esses valores podem ser texto, números ou valores lógicos. Os textos em maiúsculas e em minúsculas são equivalentes.
Arg3	Obrigatório	Variant	Col_index_num - o número da coluna na table_array da qual o valor correspondente deverá ser retornado. Um col_index_num 1 retorna o valor na primeira coluna da table_array; um col_index_num 2 retorna o valor na segunda coluna da table_array e assim por diante.
Arg4	Opcional	Variantes	Range_lookup - um valor lógico que especifica se você deseja que o método VLookup encontre uma correspondência exata ou uma correspondência aproximada.

Valor de retorno

Variant

Comentários

O V de VLookup significa vertical. Use o método VLookup em vez do método HLookup quando seus valores de comparação estiverem localizados em uma coluna à esquerda dos dados que você deseja localizar.

Se Col_index_num for menor do que 1, o método VLookup gerará um erro.

Se Col_index_num for maior do que o número de colunas na table_array, o método VLookup gerará um erro.

Se Range_lookup for True ou omitido, uma correspondência exata ou aproximada será retornada. Se uma correspondência exata não for encontrada, o próximo valor maior que for menor do que o lookup_value será retornado. Os valores na primeira coluna da table_array deverão ser posicionados em ordem crescente; caso contrário, é possível que o método VLookup não ofereça o valor correto.

Se Range_lookup for False, o método VLookup só encontrará uma correspondência exata. Nesse caso, os valores na primeira coluna de table_array não precisam ser classificados. Se houver dois ou mais valores na primeira coluna da table_array que correspondam ao lookup_value, o primeiro valor encontrado será usado. Se uma correspondência exata não for encontrada, será gerado um erro.

Ao pesquisar valores de texto na primeira coluna de table_array, verifique se os dados na primeira coluna de table_array não têm espaços de liderança, espaços à direita, uso inconsistente de aspas retas (' ou ") e encaracoladas (‘ ou “) ou caracteres não impressão digital. Nesses casos, o método VLookup pode dar um valor incorreto ou inesperado. Para saber mais sobre como limpar ou cortar valores, veja os métodos Clean e Trim.

Ao pesquisar valores de número ou de data, verifique se os dados da primeira coluna da table_array não estão armazenados como valores de texto. Nesse caso, o método VLookup pode dar um valor incorreto ou inesperado.

Se range_lookup for False e lookup_value for texto, você poderá usar os caracteres curinga, o ponto de interrogação (?) e o asterisco (*), em lookup_value. Um ponto de interrogação corresponde a qualquer caractere único; um asterisco corresponde a qualquer sequência de caracteres. Se quiser localizar um ponto de interrogação ou um asterisco, digite um til (~) antes do caractere.

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.