Strings.Replace, méthode

Article
08/21/2007

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.

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

Syntaxe

'Déclaration
Public Shared Function Replace ( _
    Expression As String, _
    Find As String, _
    Replacement As String, _
    <OptionalAttribute> Optional Start As Integer = 1, _
    <OptionalAttribute> Optional Count As Integer = -1, _
    <OptionalAttribute> Optional Compare As CompareMethod = CompareMethod.Binary _
) As String
'Utilisation
Dim Expression As String
Dim Find As String
Dim Replacement As String
Dim Start As Integer
Dim Count As Integer
Dim Compare As CompareMethod
Dim returnValue As String

returnValue = Strings.Replace(Expression, Find, Replacement, Start, Count, Compare)

public static string Replace (
    string Expression,
    string Find,
    string Replacement,
    [OptionalAttribute] int Start,
    [OptionalAttribute] int Count,
    [OptionalAttribute] CompareMethod Compare
)

public:
static String^ Replace (
    String^ Expression, 
    String^ Find, 
    String^ Replacement, 
    [OptionalAttribute] int Start, 
    [OptionalAttribute] int Count, 
    [OptionalAttribute] CompareMethod Compare
)

public static String Replace (
    String Expression, 
    String Find, 
    String Replacement, 
    /** @attribute OptionalAttribute() */ int Start, 
    /** @attribute OptionalAttribute() */ int Count, 
    /** @attribute OptionalAttribute() */ CompareMethod Compare
)

public static function Replace (
    Expression : String, 
    Find : String, 
    Replacement : String, 
    Start : int, 
    Count : int, 
    Compare : CompareMethod
) : String

Paramètres

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

Find
Obligatoire. Sous-chaîne recherchée.

Replacement
Obligatoire. Sous-chaîne de remplacement.

Start
Facultatif. Position dans Expression à partir de laquelle commencer la recherche de la sous-chaîne. Si cet argument est omis, la position 1 est utilisée par défaut.

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

Compare
Facultatif. 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.

Valeur de retour

Si Find est de longueur zéro ou Nothing, la valeur retournée par Replace est une copie de Expression. Si Replace est de longueur zéro, Replace retourne une copie de Expression sans occurrence de Find. Si Expression est de longueur zéro ou Nothing, ou si la valeur de Start est supérieure à la longueur de Expression, Replace retourne Nothing. Si Count a la valeur 0, Replace retourne une copie de Expression.

Notes

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

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

L'argument Compare peut prendre les valeurs suivantes :

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

Exemple

Cet exemple illustre la fonction Replace.

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

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

Replace, fonction (Visual Basic)
Liste des manipulations de chaînes
Filter, fonction (Visual Basic)

Partager via