Langue

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

Définition

Espace de noms:
Microsoft.Office.Interop.Excel
Assembly:
Microsoft.Office.Interop.Excel.dll

Recherchez et SearchB(String, String, Object)localisez une chaîne de texte dans une deuxième chaîne de texte et renvoyez le numéro de la position de départ de la première chaîne de texte à partir du premier caractère de la deuxième chaîne de texte.

public double Search(string Arg1, string Arg2, object Arg3);
Public Function Search (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 : La recherche est destinée aux langues qui utilisent le jeu de caractères codés sur un octet (SBCS), tandis SearchB(String, String, Object) qu’elle 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 de votre ordinateur affecte la valeur de retour de la manière suivante :La fonction Recherche compte toujours chaque caractère, qu’il codé sur un octet ou sur 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 pour 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 pour 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 la fonction Rechercher pour SearchB(String, String, Object) déterminer l’emplacement d’un caractère ou d’une chaîne de texte à l’intérieur d’une autre chaîne de texte de sorte que vous pouvez utiliser les fonctions STXT et STXTB ou Replace(String, Double, Double, String) et ReplaceB(String, Double, Double, String) pour modifier le texte.

Rechercher et SearchB(String, String, Object) ne respectent pas la casse. Si vous voulez 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 la 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. La recherche commence par le caractère 8, trouve find_text au caractère suivant et renvoie le nombre 9. La recherche renvoie 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.

S’applique à