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

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

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.

public object VLookup (object Arg1, object Arg2, object Arg3, object Arg4);

Public Function VLookup (Arg1 As Object, Arg2 As Object, Arg3 As Object, Optional Arg4 As Object) As Object

Parâmetros

Arg1

Object

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 o lookup_value for menor do que o menor valor da primeira coluna de table_array, VLOOKUP retornará o valor de erro #N/A.

Arg2

Object

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

Object

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

Object

Range_lookup - um valor lógico que especifica se você deseja que o VLookup(Object, Object, Object, Object) método encontre uma correspondência exata ou uma correspondência aproximada:

Retornos

Object

Comentários

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

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 verdadeiro 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 falso, o método VLookup só encontrará uma correspondência exata. Nesse caso, os valores da primeira coluna da 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 encaracolados ( ' ou ") ou caracteres não impressos. Nesses casos, o método VLookup pode dar um valor incorreto ou inesperado. Para obter informações sobre como limpo ou cortar valores, consulte os Clean(String) métodos eTrim(String). 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 falso 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.