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.

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 PROCV localizará apenas 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 matriz_tabela, verifique se os dados na primeira coluna de matriz_tabela não têm espaços à esquerda, espaços à direita, uso inconsistente de aspas normais' ( "ou) e curvas‘ ( “or) marcas ou caracteres não-imprimíveis. 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 valor_procurado for text, você poderá usar os caracteres curinga, ponto de interrogação (?) e asterisco (*) em valor_procurado. Um ponto de interrogação corresponde a qualquer caractere único; um asterisco corresponde a qualquer sequência de caracteres. Se você quiser localizar um ponto de interrogação ou asterisco real, digite um til (~) antes do caractere.

VLookup (Arg1, Arg2, ..., Arg4)


Dim arrVLookup() As Variant
arrVLookup() = WorksheetFunction.VLookup(Arg1:=, Arg2:=, Arg3:=)

Arguments

Arg1, Arg2, ..., Arg4

Arg1 - 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 valor_procurado for menor do que o menor valor na primeira coluna de matriz_tabela, PROCV retornará o valor de erro #N/a

Arg2 - 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 - 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 - Range_lookup-um valor lógico que especifica se você deseja que o método VLOOKUP localize uma correspondência exata ou uma correspondência aproximada