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

Definición

Espacio de nombres:

Microsoft.Office.Interop.Excel

Ensamblado:

Microsoft.Office.Interop.Excel.dll

Devuelve la posición relativa de un elemento en una matriz que coincida con un valor especificado en el orden indicado. Use Match en lugar de una de las Lookup(Object, Object, Object) funciones cuando necesite la posición de un elemento en un rango en lugar del propio elemento.

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

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

Parámetros

Arg1

Object

Valor_buscado: el valor que se utiliza para buscar un valor en una tabla.

Arg2

Object

Matriz_buscada: rango continuo de celdas que contienen posibles valores de búsqueda. El argumento de matriz_buscada debe ser una matriz o una referencia a una matriz.

Arg3

Object

Tipo_de_coincidencia: el número -1, 0 o 1. El tipo de coincidencia especifica cómo Microsoft Excel compara el argumento de valor_búsqueda con los valores de la matriz_buscada.

Devoluciones

Double

Comentarios

El argumento de valor_buscado es el valor para el que se desea encontrar una coincidencia en la matriz_buscada. Por ejemplo, al buscar el número de una persona en un listín telefónico se utiliza el nombre de la persona como valor de búsqueda, pero el número de teléfono es el valor que se desea obtener.

El argumento de valor_buscado puede ser un valor (número, texto o valor lógico) o una referencia de celda a un número, texto o valor lógico.

Si match_type es 1, Match busca el valor más grande que sea menor o igual que lookup_value. Lookup_array debe colocarse en orden ascendente: ...-2, -1, 0, 1, 2, ..., A-Z, false, true.

Si match_type es 0, Match busca el primer valor que es exactamente igual a lookup_value. El argumento de matriz_buscada puede estar en cualquier orden.

Si match_type es -1, Match busca el valor más pequeño que sea mayor o igual que lookup_value. Lookup_array deben colocarse en orden descendente: true, false, Z-A, ... 2, 1, 0, -1, -2, ..., etc. Si se omite match_type, se supone que es 1.

Match devuelve la posición del valor coincidente dentro de lookup_array, no el propio valor. Por ejemplo, MATCH("b",{"a","b","c"},0) devuelve 2, que es la posición relativa de "b" dentro de la matriz {"a","b","c"}.

La coincidencia no distingue entre mayúsculas y minúsculas al hacer coincidir los valores de texto.

Si Match no se encuentra correctamente en la búsqueda de una coincidencia, devuelve el valor de error #N/A.

Si el argumento de tipo_de_coincidencia es 0 y el argumento de valor_buscado es texto, se pueden usar los caracteres comodín de signo de interrogación (?) y asterisco (*) en el argumento de valor_buscado. El signo de interrogación corresponde a cualquier carácter único, mientras que un asterisco corresponde a cualquier secuencia de caracteres. Si desea buscar un signo de interrogación o asterisco reales, escriba una tilde (~) delante del carácter.