Strings.Replace(String, String, String, Int32, Int32, CompareMethod) Méthode
Définition
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
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
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 |