StringBuilder.Replace Méthode

Définition

Espace de noms:: System.Text

Assemblys:: mscorlib.dll, System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

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.

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

Nom	Description
Replace(Char, Char)	Remplace toutes les occurrences d’un caractère spécifié dans cette instance par un autre caractère spécifié.
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(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 Replace méthode.

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.

*/

open System.Text

let show (sbs: StringBuilder) =
    let rule1 = "0----+----1----+----2----+----3----+----4---"
    let rule2 = "01234567890123456789012345678901234567890123"
    printfn $"{rule1}\n{rule2}\n{sbs}\n"

//         0----+----1----+----2----+----3----+----4---
//         01234567890123456789012345678901234567890123
let str = "The quick br!wn d#g jumps #ver the lazy cat."
let sb = StringBuilder str

printfn "StringBuilder.Replace method\n"

printfn "Original value:"
show sb

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

printfn "Final value:"
show sb

// 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.

Imports System.Text

Class Sample
   Public Shared Sub Main()
      '                    0----+----1----+----2----+----3----+----4---
      '                    01234567890123456789012345678901234567890123
      Dim str As String = "The quick br!wn d#g jumps #ver the lazy cat."
      Dim sb As New StringBuilder(str)
      
      Console.WriteLine()
      Console.WriteLine("StringBuilder.Replace method")
      Console.WriteLine()
      
      Console.WriteLine("Original value:")
      Show(sb)
      
      sb.Replace("#"c, "!"c, 15, 29)   ' Some '#' -> '!'
      Show(sb)
      sb.Replace("!"c, "o"c)           ' 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)
   End Sub
   
   Public Shared Sub Show(sbs As StringBuilder)
      Dim rule1 As String = "0----+----1----+----2----+----3----+----4---"
      Dim rule2 As String = "01234567890123456789012345678901234567890123"
      
      Console.WriteLine(rule1)
      Console.WriteLine(rule2)
      Console.WriteLine("{0}", sbs.ToString())
      Console.WriteLine()
   End Sub
End Class
'
'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)

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);

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

member this.Replace : char * char -> System.Text.StringBuilder

Public Function Replace (oldChar As Char, newChar As Char) As StringBuilder

Paramètres

oldChar: Char

Caractère à remplacer.

newChar: Char

Caractère qui remplace oldChar.

Retours

StringBuilder

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

Remarques

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

S’applique à

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.

public:
 System::Text::StringBuilder ^ Replace(System::String ^ oldValue, System::String ^ newValue);

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

member this.Replace : string * string -> System.Text.StringBuilder

Public Function Replace (oldValue As String, newValue As String) As StringBuilder

Paramètres

oldValue: String

La chaîne à remplacer.

newValue: String

Chaîne qui remplace oldValue, ou null.

Retours

StringBuilder

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

Exceptions

ArgumentNullException

oldValue a la valeur null.

ArgumentException

La longueur est égale oldValue à zéro.

ArgumentOutOfRangeException

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

Remarques

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

Voir aussi

Remove(Int32, Int32)

S’applique à

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é.

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

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

member this.Replace : char * char * int * int -> System.Text.StringBuilder

Public Function Replace (oldChar As Char, newChar As Char, startIndex As Integer, count As Integer) As StringBuilder

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

StringBuilder

Référence à cette instance remplacée oldChar par dans la plage comprise entre startIndexcount + startIndex-1.newChar

Exceptions

ArgumentOutOfRangeException

startIndex + count est supérieur à 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 l’instance actuelle. La taille de l’objet actuel StringBuilder n’est pas modifiée après le remplacement.

S’applique à

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.

public:
 System::Text::StringBuilder ^ Replace(System::String ^ oldValue, System::String ^ newValue, int startIndex, int count);

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

member this.Replace : string * string * int * int -> System.Text.StringBuilder

Public Function Replace (oldValue As String, newValue As String, startIndex As Integer, count As Integer) As StringBuilder

Paramètres

oldValue: String

La 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

StringBuilder

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

Exceptions

ArgumentNullException

oldValue a la valeur null.

ArgumentException

La longueur est égale oldValue à zéro.

ArgumentOutOfRangeException

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épasserait MaxCapacity.

Remarques

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

Voir aussi

Remove(Int32, Int32)

S’applique à

Commentaires

Cette page a-t-elle été utile ?