WorksheetFunction.Match(Object, Object, Object) Метод

Определение

Пространство имен:

Microsoft.Office.Interop.Excel

Сборка:

Microsoft.Office.Interop.Excel.dll

Возвращает относительное положение элемента в массиве, соответствующее указанному значению в указанном порядке. Используйте функцию Match вместо одной из функций, Lookup(Object, Object, Object) если требуется расположение элемента в диапазоне, а не самого элемента.

public double Match (object Arg1, object Arg2, object Arg3);

Public Function Match (Arg1 As Object, Arg2 As Object, Optional Arg3 As Object) As Double

Параметры

Arg1

Object

Lookup_value — значение, используемое для поиска нужного значения в таблице.

Arg2

Object

Lookup_array — непрерывный диапазон ячеек, содержащих возможные значения подстановки. Lookup_array должен быть массивом или ссылкой на массив.

Arg3

Object

Match_type — число -1, 0 или 1. Match_type указывает, как Microsoft Excel сопоставляет lookup_value со значениями в lookup_array.

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

Double

Комментарии

Lookup_value — это значение, которое нужно сопоставить в lookup_array. Например, когда вы ищете номер пользователя в телефонной книге, вы используете имя человека в качестве значения поиска, но номер телефона — это нужное значение.

Lookup_value может быть значением (число, текст или логическое значение) или ссылкой на ячейку числа, текста или логического значения.

Если match_type равно 1, функция Match находит наибольшее значение, которое меньше или равно lookup_value. Lookup_array должны располагаться в порядке возрастания: ...-2, -1, 0, 1, 2, ..., A–Z, false, true.

Если match_type равно 0, функция Match находит первое значение, которое точно равно lookup_value. Lookup_array может быть в любом порядке.

Если match_type равно -1, функция Match находит наименьшее значение, больше или равное lookup_value. Lookup_array должны размещаться в порядке убывания: true, false, Z-A, ... 2, 1, 0, -1, -2, ..., и т. д. Если match_type опущен, предполагается, что значение равно 1.

Функция Match возвращает позицию соответствующего значения в lookup_array, а не само значение. Например, функция MATCH("b",{"a","b","c"},0) возвращает значение 2, относительное положение "b" в массиве {"a","b","c"}.

Сопоставление не различает буквы верхнего и нижнего регистров при сопоставлении текстовых значений.

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

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