WorksheetFunction.VLookup(Object, Object, Object, Object) Méthode

Définition

Espace de noms:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

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.

public object VLookup (object Arg1, object Arg2, object Arg3, object Arg4);

Public Function VLookup (Arg1 As Object, Arg2 As Object, Arg3 As Object, Optional Arg4 As Object) As Object

Paramètres

Arg1

Object

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érieur à la plus petite valeur dans la première colonne de table_array, la fonction VLOOKUP renvoie la valeur d'erreur #N/A.

Arg2

Object

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

Object

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

Object

Range_lookup : valeur logique qui spécifie si vous souhaitez que la VLookup(Object, Object, Object, Object) méthode trouve une correspondance exacte ou approximative :

Retours

Object

Remarques

Le V de la méthode VLookup désigne l’aspect vertical. Utilisez la méthode VLookup au lieu de la HLookup(Object, Object, Object, Object) méthode lorsque vos valeurs de comparaison se trouvent dans une colonne à gauche des données que vous souhaitez rechercher.

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 true ou omis, une correspondance exacte ou approximative est retourné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 a la valeur false, la méthode VLookup ne trouve qu’une correspondance exacte. Dans ce cas, les valeurs dans 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.

Lors de la recherche de valeurs de texte dans la première colonne de table_array, assurez-vous que les données de la première colonne de table_array n’ont pas d’espaces de début, d’espaces de fin, d’utilisation incohérente de guillemets droits ( ' ou " ) et courbés ( ' ou « ) ou de caractères non imprimables. Dans ce cas, la méthode VLookup peut donner une valeur incorrecte ou inattendue. Pour plus d’informations sur la façon d’propre ou de découper des valeurs, consultez les Clean(String) méthodes et Trim(String) . 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 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.