WorksheetFunction.HLookup method (Excel)

Выполняет поиск значения в первой строке таблицы или массива значений и возвращает значение, находящееся в том же столбце в строке, указанной в таблице или массиве. Функция HLookup используется, когда сравниваемые значения расположены в первой строке таблицы данных, а возвращаемые — на несколько строк ниже. Пользуйтесь функцией ВLookup , если сравниваемые значения находятся в столбце слева от искомых данных.

Синтаксис

выражение. HLookup (Arg1, Arg2, Arg3, Arg4)

выражение Переменная, представляющая объект WorksheetFunction .

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
Арг1	Обязательный	Variant	Lookup_value — значение, которое требуется найти в первой строке таблицы. Lookup_value может быть значением, ссылкой или текстовой строкой.
Арг2	Обязательный	Variant	Table_array — таблица сведений, в которой производится поиск данных. Можно использовать ссылку на диапазон или имя диапазона.
Арг3	Обязательный	Variant	Row_index_num — номер строки в table_array, из которой будет возвращено соответствующее значение. При row_index_num 1 возвращается значение из первой строки в table_array, при row_index_num 2 возвращается значение из второй строки в table_array и т. д. Если row_index_num меньше 1, функция HLookup возвращает #VALUE! значение ошибки; если row_index_num больше, чем количество строк в table_array, функция HLookup возвращает #REF! значение ошибки.
Арг4	Необязательный	Variant	Range_lookup — логическое значение, которое определяет, какое соответствие должна найти функция HLookup — точное или приблизительное. Если этот аргумент имеет значение "Истина " или опущен, возвращается приблизительное соответствие. Другими словами, если точное совпадение не найдено, возвращается наибольшее из значений, меньших lookup_value. Если имеет значение False, функция HLookup найдет точное соответствие. Если таковой не найден, возвращается значение ошибки #N/A.

Возвращаемое значение

Variant

Примечания

Если функция HLookup не может найти lookup_value и range_lookup имеет значение True, она использует наибольшее значение, которое меньше lookup_value.

Если lookup_value меньше, чем наименьшее значение в первой строке table_array, функция HLookup возвращает значение ошибки #N/A.

Если range_lookup имеет значение "ложь " и lookup_value является текстом, в lookup_value можно использовать подстановочные знаки: вопросительный знак (?) и звездочку (*). Вопросительный знак соответствует любому отдельно взятому символу; звездочка — любой последовательности символов. Если требуется найти сам вопросительный знак или звездочку, перед ними следует ввести знак тильды (~).

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.