WorksheetFunction.Match(Object, Object, Object) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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.