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

Referência

Definição

Namespace:: Microsoft.Office.Interop.Excel

Assembly:: Microsoft.Office.Interop.Excel.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Localiza um valor específico na linha superior de uma tabela ou matriz de valores e retorna um valor na mesma coluna de uma linha especificada na tabela ou matriz. Use HLookup quando seus valores de comparação estão localizados em uma linha na parte superior de uma tabela de dados e você deseja procurar um número especificado de linhas. Use VLookup(Object, Object, Object, Object) quando seus valores de comparação estão localizados em uma coluna à esquerda dos dados que você deseja encontrar.

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

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

Parâmetros

Arg1: Object

Valor_procurado - o valor a ser localizado na primeira linha da tabela. Valor_procurado pode ser um valor, uma referência ou uma sequência de caracteres de texto.

Arg2: Object

Matriz_tabela - uma tabela de informações onde os dados devem ser procurados. Use uma referência para um intervalo ou um nome de intervalo.

Arg3: Object

Row_index_num - o número da linha em table_array do qual o valor correspondente será retornado. Um row_index_num de 1 retorna o valor da primeira linha em table_array, um row_index_num de 2 retorna o segundo valor de linha em table_array e assim por diante. Se row_index_num for menor que 1, HLookup retornará o #VALUE! valor de erro; se row_index_num for maior do que o número de linhas no table_array, HLookup retornará o #REF! valor de erro.

Arg4: Object

Range_lookup - um valor lógico que especifica se você deseja que o HLookup encontre uma combinação exata ou uma combinação aproximada. Se for verdadeiro ou omitido, uma combinação aproximada será retornada. Em outras palavras, se uma correspondência exata não for localizada, o valor maior mais próximo que seja menor que o valor_procurado é retornado. Se for falso, HLookup encontrará uma combinação exata. Se nenhuma correspondência for localizada, o valor de erro #N/D será retornado.

Retornos

Object

Comentários

Se o HLookup não conseguir encontrar lookup_value, e range_lookup for verdadeiro,ele usará o maior valor que for menor que lookup_value.

Se lookup_value menor que o menor valor na primeira linha de table_array, HLookup retornará o valor de erro #N/A.

Se procurar_intervalo for FALSO e valor_procurado for texto, você pode 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 quiser localizar um ponto de interrogação ou asterisco real, digite um til (~) antes do caractere.

Aplica-se a