WorksheetFunction.SearchB(String, String, Object) Méthode

Définition

Espace de noms:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Les fonctions SEARCH et SEARCHB recherchent une chaîne de texte dans une seconde chaîne de texte, et renvoient le numéro de la position de départ de la première chaîne de texte à partir du premier caractère de la seconde chaîne de texte.

public double SearchB (string Arg1, string Arg2, object Arg3);

Public Function SearchB (Arg1 As String, Arg2 As String, Optional Arg3 As Object) As Double

Paramètres

Arg1

String

Find_text - texte à rechercher.

Arg2

String

Within_text - texte dans lequel vous souhaitez utiliser la fonction find_text.

Arg3

Object

Start_num - numéro du caractère de within_text auquel vous souhaitez commencer la recherche.

Retours

Double

Remarques

Important : Recherche est destiné à être utilisé avec les langues qui utilisent le jeu de caractères codés sur un octet (SBCS), tandis qu’elle SearchB(String, String, Object) est destinée aux langues qui utilisent le jeu de caractères codés sur deux octets (DBCS). Le paramètre de langue par défaut sur votre ordinateur affecte la valeur de retour de la manière suivante : Recherche compte toujours chaque caractère, qu’il s’agisse d’un octet ou de deux octets, comme 1, quel que soit le paramètre de langue par défaut. SearchB(String, String, Object) compte chaque caractère codé sur deux octets comme 2 lorsque vous avez activé la modification d’une langue qui prend en charge DBCS, puis que vous l’avez définie comme langue par défaut. Sinon, SearchB(String, String, Object) compte chaque caractère comme 1.

Les langues qui prennent en charge les caractères codés sur deux octets sont le japonais, le chinois (simplifié), le chinois (traditionnel) et le coréen.

Utilisez Recherche et SearchB(String, String, Object) pour déterminer l’emplacement d’un caractère ou d’une chaîne de texte dans une autre chaîne de texte afin de pouvoir utiliser les fonctions MID et MIDB ou Replace(String, Double, Double, String) et ReplaceB(String, Double, Double, String) pour modifier le texte.

Recherche et SearchB(String, String, Object) ne respectent pas la casse. Si vous souhaitez effectuer une recherche respectant la casse, vous pouvez utiliser Find(String, String, Object) et FindB(String, String, Object).

Vous pouvez utiliser des caractères génériques, des points d'interrogation (?) et des astérisques (*), dans find_text. 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.

Si find_text est introuvable, la valeur d'erreur #VALUE! est renvoyée.

Si start_num est omis, sa valeur est considérée comme étant 1.

Si start_num n'est pas supérieur à 0 (zéro) ou est supérieur à la longueur de within_text, la valeur d'erreur #VALUE! est renvoyée.

Utilisez start_num pour ignorer un certain nombre de caractères. En utilisant Recherche comme exemple, supposons que vous travaillez avec la chaîne de texte « AYF0093. YoungMensApparel ». Pour trouver le nombre du premier « Y » dans la partie descriptive de la chaîne de texte, définissez start_num sur 8 afin que la partie du numéro de série du texte ne fasse pas l'objet de la recherche. Recherche commence par le caractère 8, recherche find_text au caractère suivant et retourne le nombre 9. Recherche retourne toujours le nombre de caractères à partir du début de within_text, en comptant les caractères que vous ignorez si start_num est supérieur à 1.