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

Définition

Espace de noms:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.dll

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 spécifié de fois.

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

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

Find

String

Required. Sous-chaîne recherchée.

Replacement

String

Required. Sous-chaîne de remplacement.

Start

Int32

Optional. Position dans Expression laquelle démarre une sous-chaîne utilisée pour le remplacement. La valeur de retour est Replace une chaîne qui commence à Start, avec les substitutions appropriées. En cas d’omission, 1 est supposé.

Count

Int32

Optional. Nombre de substitutions de sous-chaînes à effectuer. Si elle est omise, la valeur par défaut est -1, ce qui signifie « rendre toutes les substitutions possibles ».

Compare

CompareMethod

Optional. Valeur numérique indiquant le type de comparaison à utiliser lors de l’évaluation des sous-chaînes. Consultez Paramètres des valeurs.

Retours

String

Une des valeurs suivantes.

Si	Replace renvoie
Find est de longueur nulle ou Nothing	Copie de Expression
Replace est de longueur nulle	Copie des Expression occurrences sans occurrences de Find
Expression est de longueur nulle ou Nothing, ou Start est supérieur à la longueur de Expression	Nothing
Count est 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 valeurs et Replace les Find valeurs.

L’argument Compare peut avoir les valeurs suivantes.

Constante	Description
Binary	Effectue une comparaison binaire
Text	Effectue une comparaison textuelle

Voir aussi

• Filter
• ArgumentException
• Résumé de la manipulation de chaînes