Méthode WorksheetFunction.HLookup (Excel)

Recherche une valeur dans la ligne supérieure d’une table ou d’un tableau de valeurs, puis renvoie une valeur dans la même colonne à partir d’une ligne que vous spécifiez dans la table ou le tableau. Utilisez HLookup lorsque vos valeurs de comparaison se trouvent dans une ligne du haut d’un tableau de données et que vous souhaitez examiner un nombre spécifié de lignes. Utilisez VLookup lorsque vos valeurs de comparaison se trouvent dans une colonne à gauche des données à rechercher.

Syntaxe

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

expression Variable représentant un objet WorksheetFunction.

Paramètres

Nom	Requis/Facultatif	Type de données	Description
Arg1	Obligatoire	Variant	Lookup_value - valeur à rechercher dans la première ligne de la table. Lookup_value peut être une valeur, une référence ou une chaîne de texte.
Arg2	Obligatoire	Variant	Table_array - table d'informations consultée. Utilisez une référence dans une plage ou un nom de plage.
Arg3	Obligatoire	Variant	Row_index_num - le numéro de ligne dans table_array à partir de laquelle la valeur correspondante sera renvoyée. Une valeur de row_index_num égal à 1 renvoie la valeur de première ligne dans table_array, un row_index_num 2 renvoie la valeur de deuxième ligne dans table_array et ainsi de suite. Si row_index_num est inférieur à 1, HLookup renvoie le #VALUE ! valeur d’erreur ; si row_index_num est supérieur au nombre de lignes sur table_array, HLookup renvoie le #REF ! Valeur d'erreur.
Arg4	Facultatif	Variant	Range_lookup : valeur logique qui indique si vous souhaitez que le service HLookup recherche une correspondance exacte ou approximative. Si la valeur est True ou omis, une correspondance approximative est renvoyée. En d'autres termes, si une correspondance exacte est introuvable, la valeur la plus élevée inférieure à lookup_value est renvoyée. Si la valeur est False, HLookup trouvera une correspondance exacte. Si rien n’est trouvé, la valeur d’erreur #N/A est renvoyée.

Valeur renvoyée

Variant

Remarques

Si HLookup ne trouve pas lookup_value et que range_lookup est Vrai, il utilise la plus grande valeur inférieure à lookup_value.

Si lookup_value est inférieure à la plus petite valeur dans la première ligne de table_array, HLookup renvoie la valeur d’erreur #N/A.

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.