Méthode WorksheetFunction.Lookup (Excel)

Renvoie une valeur d'une plage contenant une ligne ou une colonne, ou d'une matrice. La fonction Lookup a deux formes de syntaxe : la forme vectorielle et la forme tableau.

Syntaxe

expression. Recherche (Arg1, Arg2, Arg3)

Expression Variable qui représente un objet WorksheetFunction .

Parameters

Nom Requis/Facultatif Type de données Description
Arg1 Obligatoire Variant Lookup_value : valeur que recherche dans le premier vecteur. Valeur_cherchée peut être un nombre, du texte, une valeur logique, un nom ou une référence qui renvoie à une valeur.
Arg2 Obligatoire Variant Lookup_vector ou Array : sous forme vectorielle, plage qui ne contient qu’une seule ligne ou une colonne. Les valeurs de vecteur_recherche peuvent être du texte, des nombres ou des valeurs logiques. Dans une forme matricielle, plage de cellules qui contient du texte, des nombres ou des valeurs logiques à comparer à valeur_cherchée.
Arg3 Facultatif Variant Result_vector : utilisé uniquement avec la forme vectorielle. Plage qui ne contient qu'une ligne ou une colonne. Doit être de la même taille que vecteur_recherche.

Valeur renvoyée

Variant

Remarques

Si vous souhaitez... Consultez la rubrique Utilisation
Rechercher une valeur dans une plage contenant une seule ligne ou une colonne (appelée vecteur) et renvoyer une valeur à partir de la même position dans une seconde plage contenant une seule ligne ou colonne Forme vectorielle Utilisez la forme vectorielle lorsque vous effectuez une recherche dans une grande liste de valeurs ou lorsque les valeurs peuvent varier dans le temps.
Rechercher la valeur spécifiée dans la première ligne ou colonne et renvoyer une valeur à partir de la même position dans la dernière ligne ou colonne de la matrice Forme matricielle Utilisez la forme matricielle lorsque vous disposez d'une petite liste de valeurs et que les valeurs restent constantes dans le temps.

Forme vectorielle

Un vecteur est une plage qui ne contient qu'une seule ligne ou colonne. La forme vectorielle de la recherche recherche dans une plage d’une ligne ou une colonne (appelée vecteur) pour une valeur et retourne une valeur à partir de la même position dans une deuxième plage d’une ligne ou d’une colonne. Utilisez cette forme de la fonction Lookup lorsque vous souhaitez spécifier la plage qui contient les valeurs que vous souhaitez faire correspondre. L’autre forme de recherche recherche automatiquement dans la première colonne ou la première ligne.

Importante

Les valeurs dans lookup_vector doivent être placées dans l’ordre croissant : ...,-2, -1, 0, 1, 2, ..., A-Z, FALSE, TRUE; dans le cas contraire, La recherche risque de ne pas donner la valeur correcte. Le texte en majuscules et le texte en minuscules sont équivalents.

Si La recherche ne peut pas trouver la lookup_value, elle correspond à la valeur la plus élevée dans lookup_vector qui est inférieure ou égale à lookup_value.

Si lookup_value est inférieure à la valeur la plus petite dans lookup_vector, La recherche donne la valeur d’erreur #N/A.

Forme matricielle

La forme matricielle de La recherche recherche la valeur spécifiée dans la première ligne ou colonne d’un tableau et retourne une valeur à partir de la même position dans la dernière ligne ou colonne du tableau. Utilisez cette forme de recherche lorsque les valeurs que vous souhaitez mettre en correspondance se trouvent dans la première ligne ou colonne du tableau. Utilisez l’autre forme de recherche lorsque vous souhaitez spécifier l’emplacement de la colonne ou de la ligne.

Conseil

En général, il est préférable d’utiliser la fonction HLookup ou VLookup au lieu de la forme de tableau de Lookup. Cette forme de recherche est fournie à des fins de compatibilité avec d’autres programmes de feuille de calcul.

  • Si la recherche ne peut pas trouver la lookup_value, elle utilise la plus grande valeur du tableau qui est inférieure ou égale à lookup_value.

  • Si lookup_value est inférieure à la valeur la plus petite dans la première ligne ou colonne (selon les dimensions du tableau), la recherche renvoie la valeur d’erreur #N/A.

La forme matricielle de La recherche est très similaire aux fonctions HLookup et VLookup . La différence réside dans le fait que RechercheH recherche lookup_value dans la première ligne, RechercheV dans la première colonne et Recherche en fonction des dimensions du tableau.

  • Si le tableau couvre une zone plus large que haute (plus de colonnes que de lignes), recherche lookup_value dans la première ligne.

  • Si le tableau est carré ou est plus grand que large (plus de lignes que de colonnes), recherche dans la première colonne.

  • Avec HLookup et VLookup, vous pouvez indexer vers le bas ou l’autre, mais Recherche sélectionne toujours la dernière valeur dans la ligne ou la colonne.

Importante

Les valeurs du tableau doivent être placées dans l’ordre croissant : ...,-2, -1, 0, 1, 2, ..., A-Z, FALSE, TRUE; dans le cas contraire, La recherche risque de ne pas donner la valeur correcte. Le texte en majuscules et le texte en minuscules sont équivalents.

Remarque

Vous pouvez également utiliser la fonction Lookup comme alternative à la fonction IF pour des tests complexes ou des tests pour plus de sept conditions. Reportez-vous aux exemples de la forme matricielle.

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.