Strings.Replace(String, String, String, Int32, Int32, CompareMethod) Méthode

Référence

Définition

Espace de noms:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Source:: Strings.vb

Source:: Strings.vb

Source:: Strings.vb

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Retourne une chaîne dans laquelle une sous-chaîne spécifiée a été remplacée par une autre sous-chaîne, un nombre de fois déterminé.

public static string? Replace (string? Expression, string? Find, string? Replacement, int Start = 1, int Count = -1, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);

public static string Replace (string Expression, string Find, string Replacement, int Start = 1, int Count = -1, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);

static member Replace : string * string * string * int * int * Microsoft.VisualBasic.CompareMethod -> string

Public Function Replace (Expression As String, Find As String, Replacement As String, Optional Start As Integer = 1, Optional Count As Integer = -1, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As String

Paramètres

Expression: String

Obligatoire. Expression de chaîne contenant la sous-chaîne à remplacer.

Find: String

Obligatoire. Sous-chaîne recherchée.

Replacement: String

Obligatoire. Sous-chaîne de remplacement.

Start: Int32

Optionnel. Positionnez dans Expression qui démarre une sous-chaîne utilisée pour le remplacement. La valeur de retour de Replace est une chaîne qui commence à Start, avec les substitutions appropriées. Si cet argument est omis, la position 1 est utilisée par défaut.

Count: Int32

Optionnel. Nombre de remplacements de la sous-chaîne à effectuer. Si cet argument est omis, la valeur par défaut est -1, ce qui signifie « faire tous les remplacements possibles ».

Compare: CompareMethod

Optionnel. Valeur numérique indiquant le type de comparaison à utiliser pour l'évaluation des sous-chaînes. Consultez la section « Paramètres » pour obtenir les valeurs.

Retours

String

Une des valeurs suivantes.

If	Valeur retournée par la fonction Replace
`Find` est de longueur nulle ou `Nothing`	Copie de `Expression`
`Replace` est de longueur nulle	Copie de `Expression` sans occurrence de `Find`
`Expression` est de longueur nulle ou `Nothing`, ou `Start` est supérieur à la longueur de `Expression`	`Nothing`
L'argument `Count` a la valeur 0	Copie de `Expression`

Exceptions

ArgumentException

Count< -1 ou Start<= 0.

Exemples

Cet exemple illustre la Replace fonction.

Dim TestString As String = "Shopping List"  
' Returns "Shipping List".  
Dim aString As String = Replace(TestString, "o", "i")

Remarques

La valeur de retour de la Replace fonction est une chaîne qui commence à la position spécifiée par Start et se termine à la fin de la Expression chaîne, avec les substitutions effectuées comme spécifié par les Find valeurs et Replace .

L’argument Compare peut avoir les valeurs suivantes.

Constant	Description
`Binary`	Effectue une comparaison binaire
`Text`	Effectue une comparaison textuelle

S’applique à