WorksheetFunction.VLookup method (Excel)

Выполняет поиск значения в первом столбце массива таблиц и возвращает значение в той же строке из другого столбца в массиве таблиц.

Синтаксис

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

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

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
Арг1	Обязательный	Variant	Lookup_value - значение для поиска в первом столбце таблицы. Lookup_value может быть значением или ссылкой. Если lookup_value меньше, чем наименьшее значение в первом столбце table_array, функция VLookup возвращает значение ошибки #N/A.
Арг2	Обязательный	Variant	Table_array — два или более столбцов данных. Можно использовать ссылку на диапазон или имя диапазона. Значения в первом столбце table_array — это значения, которые искал lookup_value. Эти значения могут быть текстом, числами или логическими значениями. В текстовых строках регистр букв не учитывается.
Арг3	Обязательный	Variant	Col_index_num - номер столбца в table_array, из которого должно быть возвращено совпадающее значение. При col_index_num 1 возвращается значение в первом столбце в table_array; При col_index_num 2 возвращается значение второго столбца в table_array и т. д.
Арг4	Необязательный	Variant	Range_lookup — логическое значение, которое определяет, должно ли метод VLookup найти точное или приблизительное совпадение.

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

Variant

Примечания

V в VLookup означает вертикальный. Используйте метод VLookup вместо метода HLookup , если сравниваемые значения находятся в столбце слева от данных, которые необходимо найти.

Если Col_index_num меньше 1, метод VLookup генерирует ошибку.

Если Col_index_num больше, чем количество столбцов в table_array, метод VLookup генерирует ошибку.

Если Range_lookup имеет значение True или опущен, возвращается точное или приблизительное совпадение. Если точное совпадение не найдено, возвращается наибольшее из значений, меньших lookup_value. Значения в первом столбце table_array должны быть помещены в порядке сортировки по возрастанию. в противном случае метод VLookup может выдать неверное значение.

Если Range_lookup имеет значение False, метод VLookup найдет только точное совпадение. В этом случае значения в первом столбце table_array не нужно сортировать. Если в первом столбце table_array есть два или более значений, совпадающих с lookup_value, используется первое найденное значение. Если точное совпадение не найдено, возникает ошибка.

При поиске текстовых значений в первом столбце table_array table_array убедитесь, что данные в нем не содержат начальных или конечных пробелов, недопустимых прямых (' или ") и изогнутых (‘ или “) кавычек либо непечатаемых символов. В этих случаях метод VLookup может выдавать неправильное или неожиданное значение. Сведения о том, как очистить или обрезать значения, см. в разделах "Очистить " и "Обрезать ".

При поиске числовых значений или значений дат убедитесь, что данные в первом столбце table_array не являются текстовыми значениями. В этом случае метод VLookup может выдать неправильное или непредвиденное значение.

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

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

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