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

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

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 o HLookup quando os valores de comparação estiverem localizados em uma linha na parte superior de uma tabela de dados e você quiser examinar um número especificado de linhas. Use VLookup(Object, Object, Object, Object) quando os valores de comparação estiverem 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 no 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 valor da segunda linha em table_array e assim por diante. Se row_index_num for menor que 1, o HLookup retornará o #VALUE! valor de erro; se row_index_num for maior que o número de linhas em table_array, o 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 correspondência exata ou uma correspondência aproximada. Se true ou omitido, uma correspondência 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, o HLookup encontrará uma correspondência exata. Se nenhuma correspondência for localizada, o valor de erro #N/D será retornado.

Retornos

Object

Comentários

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

Se lookup_value for menor que o menor valor da primeira linha de table_array, o 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 você quiser localizar um ponto de interrogação ou um asterisco, digite um til (~) antes do caractere.