Méthode WorksheetFunction.VLookup (Excel)

Recherche une valeur dans la première colonne d'un tableau et renvoie une valeur dans la même ligne dans une autre colonne du tableau.

Syntaxe

expression. VLookup (arg1, arg2, arg3, arg4)

expression Variable représentant un objet WorksheetFunction.

Paramètres

Nom	Requis/Facultatif	Type de données	Description
Arg1	Obligatoire	Variante	Lookup_value - valeur à rechercher dans la première colonne du tableau. Lookup_value peut être une valeur ou une référence. Si lookup_value est inférieure à la plus petite valeur dans la première colonne de table_array, VLookup renvoie la valeur d’erreur #N/A.
Arg2	Obligatoire	Variante	Table_array - deux ou plusieurs colonnes de données. Utilisez une référence à une plage ou à un nom de plage. Les valeurs dans la première colonne de table_array sont les valeurs recherchées par lookup_value. Ces valeurs peuvent être du texte, des nombres ou des valeurs logiques. Le texte en majuscules et le texte en minuscules sont équivalents.
Arg3	Obligatoire	Variante	Col_index_num - le numéro de colonne dans table_array à partir de laquelle la valeur correspondante sera renvoyée. Une valeur de col_index_num égale à 1 renvoie la valeur de première colonne dans table_array, un col_index_num 2 renvoie la valeur de deuxième colonne dans table_array et ainsi de suite.
Arg4	Facultatif	Variant	Range_lookup : valeur logique qui indique si vous souhaitez que la méthode VLookup recherche une correspondance exacte ou approximative.

Valeur renvoyée

Variant

Remarques

Le V de la méthode VLookup désigne l’aspect vertical. Utilisez la méthode VLookup au lieu de la méthode HLookup lorsque les valeurs de comparaison se trouvent dans une colonne à gauche des données que vous recherchez.

Si Col_index_num est inférieur à 1, la méthode VLookup génère une erreur.

Si Col_index_num est supérieur au nombre de colonnes dans table_array, la méthode VLookup génère une erreur.

Si Range_lookup est Vrai ou omis, une correspondance exacte ou approximative est renvoyée. En d’autres termes, si une correspondance exacte est introuvable, la plus grande valeur inférieure à lookup_value est renvoyée. Les valeurs dans la première colonne de table_array doivent être placées en ordre croissant ; sinon, la méthodeVLookup peut ne pas donner la valeur correcte.

Si Range_lookup est False, la méthode VLookup ne trouvera qu’une correspondance exacte. Dans ce cas, les valeurs de la première colonne de table_array n’ont pas besoin d’être triées. Si deux ou plusieurs valeurs dans la première colonne de table_array correspondent à lookup_value, la première valeur trouvée est utilisée. Si aucune correspondance exacte n'est trouvée, une erreur est générée.

Si vous cherchez des valeurs textuelles dans la première colonne de table_array, assurez-vous que les données de la première colonne de table_array sont exemptes de tout espace d’en-tête, espace de fin, caractère non imprimable et que vous ne remarquez aucune utilisation incohérente des guillemets ou apostrophes droits (' ou ") et courbes (‘ ou “). Dans ce cas, la méthode VLookup peut donner une valeur incorrecte ou inattendue. Pour plus d’informations sur comment nettoyer ou supprimer des valeurs, voir les méthodes Nettoyer et Découper.

Lorsque vous recherchez des valeurs numériques ou des valeurs de date, assurez-vous que les données de la première colonne de table_array ne sont pas stockées sous forme de valeurs de texte. Dans ce cas, la méthode VLookup peut fournir une valeur incorrecte ou inattendue..

Si range_lookup équivaut à False et lookup_value à du texte, vous pouvez utiliser les caractères génériques, le point d’interrogation ( ?) et l’astérisque (*) 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.

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.