StringBuilder.Replace Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Text

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Sostituisce tutte le occorrenze di un carattere o di una stringa specificata in questa istanza con un altro carattere o un'altra stringa specificata.

Overload

Replace(Char, Char)	Sostituisce tutte le occorrenze di un carattere specificato in questa istanza con un altro carattere specificato.
Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>)
Replace(String, String)	Sostituisce tutte le occorrenze di una stringa specificata in questa istanza con un'altra stringa specificata.
Replace(Char, Char, Int32, Int32)	Sostituisce tutte le occorrenze di un carattere specificato in una sottostringa di questa istanza con un altro carattere specificato.
Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Int32, Int32)
Replace(String, String, Int32, Int32)	Sostituisce tutte le occorrenze di una stringa specificata in una sottostringa di questa istanza con un'altra stringa specificata.

Esempio

Nell'esempio seguente viene illustrato il Replace metodo.

using namespace System;
using namespace System::Text;
void Show( StringBuilder^ sbs )
{
   String^ rule1 = "0----+----1----+----2----+----3----+----4---";
   String^ rule2 = "01234567890123456789012345678901234567890123";
   Console::WriteLine( rule1 );
   Console::WriteLine( rule2 );
   Console::WriteLine( "{0}", sbs );
   Console::WriteLine();
}

int main()
{
   
   //                  0----+----1----+----2----+----3----+----4---
   //                  01234567890123456789012345678901234567890123
   String^ str = "The quick br!wn d#g jumps #ver the lazy cat.";
   StringBuilder^ sb = gcnew 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 );
}

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

*/

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)

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Sostituisce tutte le occorrenze di un carattere specificato in questa istanza con un altro carattere specificato.

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

Parametri

oldChar: Char

Carattere da sostituire.

newChar: Char

Carattere che sostituisce oldChar.

Restituisce

StringBuilder

Riferimento a questa istanza con oldChar sostituito da newChar.

Commenti

Questo metodo esegue un confronto ordinale con distinzione tra maiuscole e minuscole per identificare le occorrenze di oldChar nell'istanza corrente. Le dimensioni dell'istanza corrente StringBuilder sono invariate dopo la sostituzione.

Si applica a

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

Origine:: StringBuilder.cs

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

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

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

Public Function Replace (oldValue As ReadOnlySpan(Of Char), newValue As ReadOnlySpan(Of Char)) As StringBuilder

Parametri

oldValue: ReadOnlySpan<Char>

newValue: ReadOnlySpan<Char>

Restituisce

StringBuilder

Si applica a

Replace(String, String)

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Sostituisce tutte le occorrenze di una stringa specificata in questa istanza con un'altra stringa specificata.

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

public System.Text.StringBuilder Replace (string oldValue, 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

Parametri

oldValue: String

Stringa da sostituire.

newValue: String

Stringa che sostituisce oldValue oppure null.

Restituisce

StringBuilder

Riferimento a questa istanza con tutte le istanze di oldValue sostituite da newValue.

Eccezioni

ArgumentNullException

oldValue è null.

ArgumentException

La lunghezza di oldValue è zero.

ArgumentOutOfRangeException

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Questo metodo esegue un confronto ordinale con distinzione tra maiuscole e minuscole per identificare le occorrenze di oldValue nell'istanza corrente. Se newValue è null o String.Empty, tutte le occorrenze di oldValue vengono rimosse.

Vedi anche

Remove(Int32, Int32)

Si applica a

Replace(Char, Char, Int32, Int32)

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Sostituisce tutte le occorrenze di un carattere specificato in una sottostringa di questa istanza con un altro carattere specificato.

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

Parametri

oldChar: Char

Carattere da sostituire.

newChar: Char

Carattere che sostituisce oldChar.

startIndex: Int32

Posizione in questa istanza in cui inizia la sottostringa.

count: Int32

Lunghezza della sottostringa.

Restituisce

StringBuilder

Riferimento a questa istanza con oldChar sostituito da newChar nell'intervallo compreso tra startIndex e startIndex + count -1.

Eccezioni

ArgumentOutOfRangeException

startIndex + count è maggiore della lunghezza del valore di questa istanza.

-oppure-

startIndex o count è minore di zero.

Commenti

Questo metodo esegue un confronto ordinale con distinzione tra maiuscole e minuscole per identificare le occorrenze di oldChar nell'istanza corrente. La dimensione dell'oggetto corrente StringBuilder rimane invariata dopo la sostituzione.

Si applica a

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

Origine:: StringBuilder.cs

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

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

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

Public Function Replace (oldValue As ReadOnlySpan(Of Char), newValue As ReadOnlySpan(Of Char), startIndex As Integer, count As Integer) As StringBuilder

Parametri

oldValue: ReadOnlySpan<Char>

newValue: ReadOnlySpan<Char>

startIndex: Int32

count: Int32

Restituisce

StringBuilder

Si applica a

Replace(String, String, Int32, Int32)

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Origine:: StringBuilder.cs

Sostituisce tutte le occorrenze di una stringa specificata in una sottostringa di questa istanza con un'altra stringa specificata.

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

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

Parametri

oldValue: String

Stringa da sostituire.

newValue: String

Stringa che sostituisce oldValue oppure null.

startIndex: Int32

Posizione in questa istanza in cui inizia la sottostringa.

count: Int32

Lunghezza della sottostringa.

Restituisce

StringBuilder

Riferimento a questa istanza con tutte le istanze di oldValue sostituite da newValue nell'intervallo compreso tra startIndex e startIndex + count - 1.

Eccezioni

ArgumentNullException

oldValue è null.

ArgumentException

La lunghezza di oldValue è zero.

ArgumentOutOfRangeException

startIndex o count è minore di zero.

-oppure-

La somma di startIndex e count indica una posizione di carattere non all'interno di questa istanza.

-oppure-

Aumentando il valore di questa istanza, verrebbe superato il limite di MaxCapacity.

Commenti

Questo metodo esegue un confronto ordinale con distinzione tra maiuscole e minuscole per identificare le occorrenze di oldValue nella sottostringa specificata. Se newValue è null o String.Empty, tutte le occorrenze di oldValue vengono rimosse.

Vedi anche

Remove(Int32, Int32)

Si applica a

StringBuilder.Replace Metodo

Definizione

Overload

Esempio

Replace(Char, Char)

Parametri

Restituisce

Commenti

Si applica a

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

Parametri

Restituisce

Si applica a

Replace(String, String)

Parametri

Restituisce

Eccezioni

Commenti

Vedi anche

Si applica a

Replace(Char, Char, Int32, Int32)

Parametri

Restituisce

Eccezioni

Commenti

Si applica a

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

Parametri

Restituisce

Si applica a

Replace(String, String, Int32, Int32)

Parametri

Restituisce

Eccezioni

Commenti

Vedi anche

Si applica a

Commenti e suggerimenti

Risorse aggiuntive