Lire en anglais

Partager via


StringBuilder.Replace Méthode

Définition

Remplace toutes les occurrences d’un caractère ou d’une chaîne spécifié dans cette instance par un autre caractère ou chaîne spécifié.

Surcharges

Replace(Char, Char)

Remplace toutes les occurrences d’un caractère spécifié dans cette instance par un autre caractère spécifié.

Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

Remplace toutes les instances d’une étendue de caractères en lecture seule par une autre dans ce générateur.

Replace(String, String)

Remplace toutes les occurrences d’une chaîne spécifiée dans cette instance par une autre chaîne spécifiée.

Replace(Char, Char, Int32, Int32)

Remplace, dans une sous-chaîne de cette instance, toutes les occurrences d’un caractère spécifié par un autre caractère spécifié.

Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Int32, Int32)

Remplace toutes les instances d’une étendue de caractères en lecture seule par une autre dans le cadre de ce générateur.

Replace(String, String, Int32, Int32)

Remplace, dans une sous-chaîne de cette instance, toutes les occurrences d’une chaîne spécifiée par une autre chaîne spécifiée.

Exemples

L’exemple suivant illustre la méthode Replace.

using System;
using System.Text;

class Sample
{
    public static void Main()
    {
//                0----+----1----+----2----+----3----+----4---
//                01234567890123456789012345678901234567890123
    string str = "The quick br!wn d#g jumps #ver the lazy cat.";
    StringBuilder sb = new StringBuilder(str);

    Console.WriteLine();
    Console.WriteLine("StringBuilder.Replace method");
    Console.WriteLine();

    Console.WriteLine("Original value:");
    Show(sb);

    sb.Replace('#', '!', 15, 29);        // Some '#' -> '!'
    Show(sb);
    sb.Replace('!', 'o');                // All '!' -> 'o'
    Show(sb);
    sb.Replace("cat", "dog");            // All "cat" -> "dog"
    Show(sb);
    sb.Replace("dog", "fox", 15, 20);    // Some "dog" -> "fox"

    Console.WriteLine("Final value:");
    Show(sb);
    }

    public static void Show(StringBuilder sbs)
    {
    string rule1 = "0----+----1----+----2----+----3----+----4---";
    string rule2 = "01234567890123456789012345678901234567890123";

    Console.WriteLine(rule1);
    Console.WriteLine(rule2);
    Console.WriteLine("{0}", sbs.ToString());
    Console.WriteLine();
    }
}
/*
This example produces the following results:

StringBuilder.Replace method

Original value:
0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick br!wn d#g jumps #ver the lazy cat.

0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick br!wn d!g jumps !ver the lazy cat.

0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick brown dog jumps over the lazy cat.

0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick brown dog jumps over the lazy dog.

Final value:
0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick brown fox jumps over the lazy dog.

*/

Replace(Char, Char)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

Remplace toutes les occurrences d’un caractère spécifié dans cette instance par un autre caractère spécifié.

public System.Text.StringBuilder Replace (char oldChar, char newChar);

Paramètres

oldChar
Char

Caractère à remplacer.

newChar
Char

Caractère qui remplace oldChar.

Retours

Référence à cette instance avec oldChar remplacée par newChar.

Remarques

Cette méthode effectue une comparaison ordinale et sensible à la casse pour identifier les occurrences de oldChar dans l’instance actuelle. La taille de l’instance de StringBuilder actuelle n’est pas modifiée après le remplacement.

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

Source:
StringBuilder.cs

Remplace toutes les instances d’une étendue de caractères en lecture seule par une autre dans ce générateur.

public System.Text.StringBuilder Replace (ReadOnlySpan<char> oldValue, ReadOnlySpan<char> newValue);

Paramètres

oldValue
ReadOnlySpan<Char>

Étendue de caractères en lecture seule à remplacer.

newValue
ReadOnlySpan<Char>

Étendue de caractères en lecture seule à remplacer oldValue par.

Retours

Remarques

Si newValue est vide, les instances de oldValue sont supprimées de ce générateur.

S’applique à

.NET 9
Produit Versions
.NET 9

Replace(String, String)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

Remplace toutes les occurrences d’une chaîne spécifiée dans cette instance par une autre chaîne spécifiée.

public System.Text.StringBuilder Replace (string oldValue, string newValue);
public System.Text.StringBuilder Replace (string oldValue, string? newValue);

Paramètres

oldValue
String

Chaîne à remplacer.

newValue
String

Chaîne qui remplace oldValue, ou null.

Retours

Référence à cette instance avec toutes les instances de oldValue remplacées par newValue.

Exceptions

oldValue est null.

La longueur de oldValue est égale à zéro.

L’agrandissement de la valeur de cette instance dépasse MaxCapacity.

Remarques

Cette méthode effectue une comparaison ordinale et sensible à la casse pour identifier les occurrences de oldValue dans l’instance actuelle. Si newValue est null ou String.Empty, toutes les occurrences de oldValue sont supprimées.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Replace(Char, Char, Int32, Int32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

Remplace, dans une sous-chaîne de cette instance, toutes les occurrences d’un caractère spécifié par un autre caractère spécifié.

public System.Text.StringBuilder Replace (char oldChar, char newChar, int startIndex, int count);

Paramètres

oldChar
Char

Caractère à remplacer.

newChar
Char

Caractère qui remplace oldChar.

startIndex
Int32

Position dans cette instance où commence la sous-chaîne.

count
Int32

Longueur de la sous-chaîne.

Retours

Référence à cette instance avec oldChar remplacée par newChar dans la plage de startIndex à startIndex + count -1.

Exceptions

startIndex + count est supérieure à la longueur de la valeur de cette instance.

-ou-

startIndex ou count est inférieur à zéro.

Remarques

Cette méthode effectue une comparaison ordinale et sensible à la casse pour identifier les occurrences de oldChar dans l’instance actuelle. La taille de l’objet StringBuilder actuel n’est pas modifiée après le remplacement.

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Int32, Int32)

Source:
StringBuilder.cs

Remplace toutes les instances d’une étendue de caractères en lecture seule par une autre dans le cadre de ce générateur.

public System.Text.StringBuilder Replace (ReadOnlySpan<char> oldValue, ReadOnlySpan<char> newValue, int startIndex, int count);

Paramètres

oldValue
ReadOnlySpan<Char>

Étendue de caractères en lecture seule à remplacer.

newValue
ReadOnlySpan<Char>

Étendue de caractères en lecture seule à remplacer oldValue par.

startIndex
Int32

Index à démarrer dans ce générateur.

count
Int32

Nombre de caractères à lire dans ce générateur.

Retours

Remarques

Si newValue est vide, les instances de oldValue sont supprimées de ce générateur.

S’applique à

.NET 9
Produit Versions
.NET 9

Replace(String, String, Int32, Int32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

Remplace, dans une sous-chaîne de cette instance, toutes les occurrences d’une chaîne spécifiée par une autre chaîne spécifiée.

public System.Text.StringBuilder Replace (string oldValue, string newValue, int startIndex, int count);
public System.Text.StringBuilder Replace (string oldValue, string? newValue, int startIndex, int count);

Paramètres

oldValue
String

Chaîne à remplacer.

newValue
String

Chaîne qui remplace oldValue, ou null.

startIndex
Int32

Position dans cette instance où commence la sous-chaîne.

count
Int32

Longueur de la sous-chaîne.

Retours

Référence à cette instance avec toutes les instances de oldValue remplacées par newValue dans la plage de startIndex à startIndex + count - 1.

Exceptions

oldValue est null.

La longueur de oldValue est égale à zéro.

startIndex ou count est inférieur à zéro.

-ou-

startIndex plus count indique une position de caractère qui ne se trouve pas dans cette instance.

-ou-

L’agrandissement de la valeur de cette instance dépasse MaxCapacity.

Remarques

Cette méthode effectue une comparaison ordinale et sensible à la casse pour identifier les occurrences de oldValue dans la sous-chaîne spécifiée. Si newValue est null ou String.Empty, toutes les occurrences de oldValue sont supprimées.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0