Strings.InStr, méthode (Int32, String, String, CompareMethod)

Retourne un entier spécifiant la position de début de la première occurrence d'une chaîne à l'intérieur d'une autre.

Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)

Syntaxe

'Déclaration
Public Shared Function InStr ( _
    Start As Integer, _
    String1 As String, _
    String2 As String, _
    <OptionalAttribute> Optional Compare As CompareMethod = CompareMethod.Binary _
) As Integer
'Utilisation
Dim Start As Integer
Dim String1 As String
Dim String2 As String
Dim Compare As CompareMethod
Dim returnValue As Integer

returnValue = Strings.InStr(Start, String1, String2, Compare)

public static int InStr (
    int Start,
    string String1,
    string String2,
    [OptionalAttribute] CompareMethod Compare
)

public:
static int InStr (
    int Start, 
    String^ String1, 
    String^ String2, 
    [OptionalAttribute] CompareMethod Compare
)

public static int InStr (
    int Start, 
    String String1, 
    String String2, 
    /** @attribute OptionalAttribute() */ CompareMethod Compare
)

public static function InStr (
    Start : int, 
    String1 : String, 
    String2 : String, 
    Compare : CompareMethod
) : int

Paramètres

• Start
  Facultatif. Expression numérique qui définit la position de départ de chaque recherche. Si ce paramètre est omis, la recherche commence à la position du premier caractère. L'index de début est de base 1.

• String1
  Obligatoire. Expression String dans laquelle est effectuée la recherche.

• String2
  Obligatoire. Expression String recherchée.

• Compare
  Facultatif. Spécifie le type de comparaison de chaînes. Si Compare est omis, le paramètre Option Compare détermine le type de comparaison.

Notes

Pour plus d'informations, consultez la rubrique Visual Basic InStr, fonction (Visual Basic).

En général, la fonction InStr est utilisée lors de l'analyse de chaînes.

Notes

Dans les précédentes versions de Visual Basic, la fonction InStrB retourne un nombre d'octets, et non une position de caractère. Son rôle principal consiste à convertir des chaînes en applications utilisant le jeu de caractères codés sur deux octets (DBCS). Dans Visual Basic 2005, toutes les chaînes sont en Unicode et la fonction InStrB n'est plus prise en charge.

L'argument Compare peut prendre les valeurs suivantes :

Constante	Valeur	Description
Binary	0	Effectue une comparaison binaire
Text	1	Effectue une comparaison textuelle

Exemple

Cet exemple utilise la fonction InStr pour retourner la position de la première occurrence d'une chaîne à l'intérieur d'une autre.

' String to search in.
Dim SearchString As String = "XXpXXpXXPXXP"
' Search for "P".
Dim SearchChar As String = "P"

Dim TestPos As Integer
' A textual comparison starting at position 4. Returns 6.
TestPos = InStr(4, SearchString, SearchChar, CompareMethod.Text)

' A binary comparison starting at position 1. Returns 9.
TestPos = InStr(1, SearchString, SearchChar, CompareMethod.Binary)

' If Option Compare is not set, or set to Binary, return 9.
' If Option Compare is set to Text, returns 3.
TestPos = InStr(SearchString, SearchChar)

' Returns 0.
TestPos = InStr(1, SearchString, "W")

Plates-formes

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0

Voir aussi

Référence

Strings, classe
Membres Strings
Microsoft.VisualBasic, espace de noms
ArgumentException

Autres ressources

InStr, fonction (Visual Basic)
Chaînes en Visual Basic
Introduction aux chaînes dans Visual Basic
InStrRev, fonction (Visual Basic)
Option Compare, instruction
StrComp, fonction (Visual Basic)
Récapitulatif des modifications relatives à la prise en charge des éléments de programmation