Méthode WorksheetFunction.HLookup (Excel)
Recherche une valeur dans la ligne supérieure d’un tableau ou d’un tableau de valeurs, puis retourne 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 située en haut d’une table 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 que vous souhaitez rechercher.
Syntaxe
expression. HLookup (Arg1, Arg2, Arg3, Arg4)
Expression Variable qui représente un objet WorksheetFunction .
Parameters
| 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 spécifie si vous souhaitez que HLookup trouve une correspondance exacte ou approximative. Si la valeur est True ou omise, une correspondance approximative est retourné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 trouve 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 a la valeur True, elle utilise la plus grande valeur inférieure à lookup_value.
Si lookup_value est inférieure à la valeur la plus petite dans la première ligne de table_array, HLookup renvoie la valeur d’erreur #N/A.
Si range_lookup a la valeur False et que lookup_value est 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.