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

Définition

Espace de noms:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Renvoie la position relative d'un élément dans une matrice, qui correspond à une valeur spécifiée dans un ordre spécifié. Utilisez Match au lieu de l’une Lookup(Object, Object, Object) des fonctions lorsque vous avez besoin de la position d’un élément dans une plage au lieu de l’élément lui-même.

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

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

Paramètres

Arg1

Object

Lookup_value - valeur que vous utilisez pour rechercher la valeur souhaitée dans un tableau.

Arg2

Object

Lookup_array - plage de cellules contiguës contenant des valeurs de recherche possibles. Lookup_array doit être une matrice ou une référence à une matrice.

Arg3

Object

Type - nombre -1, 0 ou 1. Type spécifie la manière dont Microsoft Excel recherche Lookup_value dans Lookup_array.

Retours

Double

Remarques

Lookup_value est la valeur pour laquelle vous voulez trouver une correspondance dans Lookup_array. Par exemple, lorsque vous recherchez le numéro d’une personne dans un annuaire téléphonique, vous utilisez le nom de la personne comme valeur de recherche, mais le numéro de téléphone est la valeur souhaitée.

Lookup_value peut être une valeur (nombre, texte ou valeur logique) ou une référence de cellule à un nombre, du texte ou une valeur logique.

Si match_type est égal à 1, Match trouve la plus grande valeur inférieure ou égale à lookup_value. Lookup_array doivent être placés dans l’ordre croissant : ...-2, -1, 0, 1, 2, ..., A-Z, false, true.

Si match_type est égal à 0, Match recherche la première valeur qui est exactement égale à lookup_value. Lookup_array peut se trouver dans un ordre quelconque.

Si match_type a la valeur -1, Match trouve la plus petite valeur supérieure ou égale à lookup_value. Lookup_array doivent être placés dans l’ordre décroissant : true, false, Z-A, ... 2, 1, 0, -1, -2, ..., etc. Si match_type est omis, il est supposé être 1.

La correspondance retourne la position de la valeur correspondante dans lookup_array, et non la valeur elle-même. Par exemple, la fonction MATCH("b",{"a","b","c"},0) renvoie 2, la position relative de « b » dans la matrice {"a","b","c"}.

La correspondance ne fait pas la distinction entre les lettres majuscules et minuscules lors de la mise en correspondance de valeurs de texte.

Si Match ne parvient pas à trouver une correspondance, elle retourne la valeur d’erreur #N/A.

Si match_type la valeur 0, vous pouvez utiliser des caractères génériques, des points d'interrogation (?) et des astérisques (*), dans lookup_value. Un point d'interrogation correspond à un caractère unique, un astérisque à une séquence de caractères. Si vous souhaitez rechercher un point d'interrogation ou un astérisque, entrez un tilde (~) avant le caractère.