Condividi tramite


String.Replace Metodo

Definizione

Restituisce una nuova stringa in cui tutte le occorrenze di un carattere Unicode o di un oggetto String specificati presenti nella stringa corrente vengono sostituite con un altro carattere Unicode o oggetto String specificati.

Overload

Replace(Char, Char)

Restituisce una nuova stringa in cui tutte le occorrenze di un carattere Unicode specificato presenti in questa istanza vengono sostituite con un altro carattere Unicode specificato.

Replace(String, String)

Restituisce una nuova stringa in cui tutte le occorrenze di una stringa specificata nell'istanza corrente vengono sostituite con un'altra stringa specificata.

Replace(String, String, StringComparison)

Restituisce una nuova stringa in cui tutte le occorrenze di una stringa specificata nell'istanza corrente vengono sostituite con un'altra stringa specificata, usando il tipo di confronto specificato.

Replace(String, String, Boolean, CultureInfo)

Restituisce una nuova stringa in cui tutte le occorrenze di una stringa specificata nell'istanza corrente vengono sostituite con un'altra stringa specificata, usando le impostazioni cultura e la distinzione fra maiuscole e minuscole specificate.

Replace(Char, Char)

Origine:
String.Manipulation.cs
Origine:
String.Manipulation.cs
Origine:
String.Manipulation.cs

Restituisce una nuova stringa in cui tutte le occorrenze di un carattere Unicode specificato presenti in questa istanza vengono sostituite con un altro carattere Unicode specificato.

public:
 System::String ^ Replace(char oldChar, char newChar);
public string Replace (char oldChar, char newChar);
member this.Replace : char * char -> string
Public Function Replace (oldChar As Char, newChar As Char) As String

Parametri

oldChar
Char

Carattere Unicode da sostituire.

newChar
Char

Carattere Unicode con cui sostituire tutte le occorrenze di oldChar.

Restituisce

Stringa equivalente a questa istanza, salvo per il fatto che tutte le istanze di oldChar vengono sostituite con newChar. Se oldChar non viene trovato nell'istanza corrente, il metodo restituisce l'istanza corrente invariata.

Esempio

Nell'esempio seguente viene creato un elenco di valori delimitati da virgole sostituendo le virgole per gli spazi vuoti tra una serie di numeri.

using namespace System;
int main()
{
   String^ str = "1 2 3 4 5 6 7 8 9";
   Console::WriteLine( "Original string: \"{0}\"", str );
   Console::WriteLine( "CSV string:      \"{0}\"", str->Replace( ' ', ',' ) );
}

//
// This example produces the following output:
// Original string: "1 2 3 4 5 6 7 8 9"
// CSV string:      "1,2,3,4,5,6,7,8,9"
//
string str = "1 2 3 4 5 6 7 8 9";
Console.WriteLine($"Original string: \"{str}\"");
Console.WriteLine($"CSV string:      \"{str.Replace(' ', ',')}\"");

// This example produces the following output:
// Original string: "1 2 3 4 5 6 7 8 9"
// CSV string:      "1,2,3,4,5,6,7,8,9"
let str = "1 2 3 4 5 6 7 8 9"
printfn $"Original string: \"{str}\""
printfn $"CSV string:      \"{str.Replace(' ', ',')}\""

// This example produces the following output:
// Original string: "1 2 3 4 5 6 7 8 9"
// CSV string:      "1,2,3,4,5,6,7,8,9"
Class stringReplace1
   Public Shared Sub Main()
      Dim str As [String] = "1 2 3 4 5 6 7 8 9"
      Console.WriteLine("Original string: ""{0}""", str)
      Console.WriteLine("CSV string:      ""{0}""", str.Replace(" "c, ","c))
   End Sub
End Class
' This example produces the following output:
' Original string: "1 2 3 4 5 6 7 8 9"
' CSV string:      "1,2,3,4,5,6,7,8,9"

Commenti

Questo metodo esegue una ricerca ordinale (con distinzione tra maiuscole e minuscole e senza distinzione tra impostazioni cultura) per trovare oldChar.

Nota

Questo metodo non modifica il valore dell'istanza corrente. Restituisce invece una nuova stringa in cui tutte le occorrenze di oldChar vengono sostituite da newChar.

Poiché questo metodo restituisce la stringa modificata, è possibile concatenare le chiamate successive al Replace metodo per eseguire più sostituzioni sulla stringa originale. Le chiamate al metodo vengono eseguite da sinistra a destra. Nell'esempio seguente viene illustrato questo concetto.

string s = new('a', 3);
Console.WriteLine($"The initial string: '{s}'");
s = s.Replace('a', 'b').Replace('b', 'c').Replace('c', 'd');
Console.WriteLine($"The final string: '{s}'");

// The example displays the following output:
//       The initial string: 'aaa'
//       The final string: 'ddd'
let s = new string('a', 3)
printfn $"The initial string: '{s}'"
let s2 = s.Replace('a', 'b').Replace('b', 'c').Replace('c', 'd')
printfn $"The final string: '{s2}'"

// The example displays the following output:
//       The initial string: 'aaa'
//       The final string: 'ddd'
Module Example
   Public Sub Main()
      Dim s As New String("a"c, 3)
      Console.WriteLine("The initial string: '{0}'", s)
      s = s.Replace("a"c, "b"c).Replace("b"c, "c"c).Replace("c"c, "d"c)
      Console.WriteLine("The final string: '{0}'", s)
   End Sub
End Module
' The example displays the following output:
'       The initial string: 'aaa'
'       The final string: 'ddd'

Vedi anche

Si applica a

Replace(String, String)

Origine:
String.Manipulation.cs
Origine:
String.Manipulation.cs
Origine:
String.Manipulation.cs

Restituisce una nuova stringa in cui tutte le occorrenze di una stringa specificata nell'istanza corrente vengono sostituite con un'altra stringa specificata.

public:
 System::String ^ Replace(System::String ^ oldValue, System::String ^ newValue);
public string Replace (string oldValue, string newValue);
public string Replace (string oldValue, string? newValue);
member this.Replace : string * string -> string
Public Function Replace (oldValue As String, newValue As String) As String

Parametri

oldValue
String

Stringa da sostituire.

newValue
String

Stringa con cui sostituire tutte le occorrenze di oldValue.

Restituisce

Stringa equivalente alla stringa corrente, salvo per il fatto che tutte le istanze di oldValue vengono sostituite con newValue. Se oldValue non viene trovato nell'istanza corrente, il metodo restituisce l'istanza corrente invariata.

Eccezioni

oldValue è null.

oldValue è la stringa vuota ("").

Esempio

Nell'esempio seguente viene illustrato come utilizzare il Replace metodo per correggere un errore di ortografia.

using namespace System;
int main()
{
   String^ errString = "This docment uses 3 other docments to docment the docmentation";
   Console::WriteLine( "The original string is:\n'{0}'\n", errString );

   // Correct the spelling of S"document".
   String^ correctString = errString->Replace( "docment", "document" );
   Console::WriteLine( "After correcting the string, the result is:\n'{0}'", correctString );
}
//
// This code example produces the following output:
//
// The original string is:
// 'This docment uses 3 other docments to docment the docmentation'
//
// After correcting the string, the result is:
// 'This document uses 3 other documents to document the documentation'
//
string errString = "This docment uses 3 other docments to docment the docmentation";

Console.WriteLine($"The original string is:{Environment.NewLine}'{errString}'{Environment.NewLine}");

// Correct the spelling of "document".
string correctString = errString.Replace("docment", "document");

Console.WriteLine($"After correcting the string, the result is:{Environment.NewLine}'{correctString}'");

// This code example produces the following output:
//
// The original string is:
// 'This docment uses 3 other docments to docment the docmentation'
//
// After correcting the string, the result is:
// 'This document uses 3 other documents to document the documentation'
//
open System

let errString = "This docment uses 3 other docments to docment the docmentation"

printfn $"The original string is:{Environment.NewLine}'{errString}'{Environment.NewLine}"

// Correct the spelling of "document".

let correctString = errString.Replace("docment", "document")

printfn $"After correcting the string, the result is:{Environment.NewLine}'{correctString}'"

// This code example produces the following output:
//
// The original string is:
// 'This docment uses 3 other docments to docment the docmentation'
//
// After correcting the string, the result is:
// 'This document uses 3 other documents to document the documentation'
//
Public Class ReplaceTest
    
    Public Shared Sub Main()
        Dim errString As String = "This docment uses 3 other docments to docment the docmentation"
                
        Console.WriteLine("The original string is:{0}'{1}'{0}", Environment.NewLine, errString)

        ' Correct the spelling of "document".  
        Dim correctString As String = errString.Replace("docment", "document")
      
        Console.WriteLine("After correcting the string, the result is:{0}'{1}'", Environment.NewLine, correctString)
    End Sub
End Class
'
' This code example produces the following output:
'
' The original string is:
' 'This docment uses 3 other docments to docment the docmentation'
'
' After correcting the string, the result is:
' 'This document uses 3 other documents to document the documentation'
'

Commenti

Se newValue è null, tutte le occorrenze di oldValue vengono rimosse.

Nota

Questo metodo non modifica il valore dell'istanza corrente. Restituisce invece una nuova stringa in cui tutte le occorrenze di oldValue vengono sostituite da newValue.

Questo metodo esegue una ricerca ordinale (con distinzione tra maiuscole e minuscole e senza distinzione tra impostazioni cultura) per trovare oldValue.

Poiché questo metodo restituisce la stringa modificata, è possibile concatenare le chiamate successive al Replace metodo per eseguire più sostituzioni sulla stringa originale. Le chiamate al metodo vengono eseguite da sinistra a destra. Nell'esempio seguente viene illustrato questo concetto.

string s = "aaa";
Console.WriteLine($"The initial string: '{s}'");
s = s.Replace("a", "b").Replace("b", "c").Replace("c", "d");
Console.WriteLine($"The final string: '{s}'");

// The example displays the following output:
//       The initial string: 'aaa'
//       The final string: 'ddd'
let s = "aaa"
printfn $"The initial string: '{s}'"
let s2 = s.Replace("a", "b").Replace("b", "c").Replace("c", "d")
printfn $"The final string: '{s2}'"

// The example displays the following output:
//       The initial string: 'aaa'
//       The final string: 'ddd'
Module Example
   Public Sub Main()
      Dim s As String = "aaa"
      Console.WriteLine("The initial string: '{0}'", s)
      s = s.Replace("a", "b").Replace("b", "c").Replace("c", "d")
      Console.WriteLine("The final string: '{0}'", s)
   End Sub
End Module
' The example displays the following output:
'       The initial string: 'aaa'
'       The final string: 'ddd'

Vedi anche

Si applica a

Replace(String, String, StringComparison)

Origine:
String.Manipulation.cs
Origine:
String.Manipulation.cs
Origine:
String.Manipulation.cs

Restituisce una nuova stringa in cui tutte le occorrenze di una stringa specificata nell'istanza corrente vengono sostituite con un'altra stringa specificata, usando il tipo di confronto specificato.

public:
 System::String ^ Replace(System::String ^ oldValue, System::String ^ newValue, StringComparison comparisonType);
public string Replace (string oldValue, string? newValue, StringComparison comparisonType);
public string Replace (string oldValue, string newValue, StringComparison comparisonType);
member this.Replace : string * string * StringComparison -> string
Public Function Replace (oldValue As String, newValue As String, comparisonType As StringComparison) As String

Parametri

oldValue
String

Stringa da sostituire.

newValue
String

Stringa con cui sostituire tutte le occorrenze di oldValue.

comparisonType
StringComparison

Uno dei valori di enumerazione che determina la modalità di ricerca in oldValue all'interno di questa istanza.

Restituisce

Stringa equivalente alla stringa corrente, salvo per il fatto che tutte le istanze di oldValue vengono sostituite con newValue. Se oldValue non viene trovato nell'istanza corrente, il metodo restituisce l'istanza corrente invariata.

Eccezioni

oldValue è null.

oldValue è la stringa vuota ("").

Commenti

Se newValue è null, tutte le occorrenze di oldValue vengono rimosse.

Nota

Questo metodo non modifica il valore dell'istanza corrente. Restituisce invece una nuova stringa in cui tutte le occorrenze di oldValue vengono sostituite da newValue.

Questo metodo esegue una ricerca per trovare oldValue usando le impostazioni cultura e la distinzione tra maiuscole e minuscole descritte da comparisonType.

Poiché questo metodo restituisce la stringa modificata, è possibile concatenare le chiamate successive al Replace metodo per eseguire più sostituzioni sulla stringa originale. Le chiamate al metodo vengono eseguite da sinistra a destra. Nell'esempio seguente viene illustrato questo concetto.

string s = "aaa";
Console.WriteLine($"The initial string: '{s}'");
s = s.Replace("a", "b").Replace("b", "c").Replace("c", "d");
Console.WriteLine($"The final string: '{s}'");

// The example displays the following output:
//       The initial string: 'aaa'
//       The final string: 'ddd'
let s = "aaa"
printfn $"The initial string: '{s}'"
let s2 = s.Replace("a", "b").Replace("b", "c").Replace("c", "d")
printfn $"The final string: '{s2}'"

// The example displays the following output:
//       The initial string: 'aaa'
//       The final string: 'ddd'
Module Example
   Public Sub Main()
      Dim s As String = "aaa"
      Console.WriteLine("The initial string: '{0}'", s)
      s = s.Replace("a", "b").Replace("b", "c").Replace("c", "d")
      Console.WriteLine("The final string: '{0}'", s)
   End Sub
End Module
' The example displays the following output:
'       The initial string: 'aaa'
'       The final string: 'ddd'

Si applica a

Replace(String, String, Boolean, CultureInfo)

Origine:
String.Manipulation.cs
Origine:
String.Manipulation.cs
Origine:
String.Manipulation.cs

Restituisce una nuova stringa in cui tutte le occorrenze di una stringa specificata nell'istanza corrente vengono sostituite con un'altra stringa specificata, usando le impostazioni cultura e la distinzione fra maiuscole e minuscole specificate.

public:
 System::String ^ Replace(System::String ^ oldValue, System::String ^ newValue, bool ignoreCase, System::Globalization::CultureInfo ^ culture);
public string Replace (string oldValue, string? newValue, bool ignoreCase, System.Globalization.CultureInfo? culture);
public string Replace (string oldValue, string newValue, bool ignoreCase, System.Globalization.CultureInfo culture);
member this.Replace : string * string * bool * System.Globalization.CultureInfo -> string
Public Function Replace (oldValue As String, newValue As String, ignoreCase As Boolean, culture As CultureInfo) As String

Parametri

oldValue
String

Stringa da sostituire.

newValue
String

Stringa con cui sostituire tutte le occorrenze di oldValue.

ignoreCase
Boolean

true per ignorare le maiuscole/minuscole durante il confronto; in caso contrario, false.

culture
CultureInfo

Impostazioni cultura da usare per il confronto. Se culture è null, verranno usate le impostazioni cultura correnti.

Restituisce

Stringa equivalente alla stringa corrente, salvo per il fatto che tutte le istanze di oldValue vengono sostituite con newValue. Se oldValue non viene trovato nell'istanza corrente, il metodo restituisce l'istanza corrente invariata.

Eccezioni

oldValue è null.

oldValue è la stringa vuota ("").

Commenti

Se newValue è null, tutte le occorrenze di oldValue vengono rimosse.

Nota

Questo metodo non modifica il valore dell'istanza corrente. Restituisce invece una nuova stringa in cui tutte le occorrenze di oldValue vengono sostituite da newValue.

Questo metodo esegue una ricerca per trovare oldValue usando la distinzione tra maiuscole e minuscole specificateculture.ignoreCase

Poiché questo metodo restituisce la stringa modificata, è possibile concatenare le chiamate successive al Replace metodo per eseguire più sostituzioni sulla stringa originale. Le chiamate al metodo vengono eseguite da sinistra a destra. Nell'esempio seguente viene illustrato questo concetto.

string s = "aaa";
Console.WriteLine($"The initial string: '{s}'");
s = s.Replace("a", "b").Replace("b", "c").Replace("c", "d");
Console.WriteLine($"The final string: '{s}'");

// The example displays the following output:
//       The initial string: 'aaa'
//       The final string: 'ddd'
let s = "aaa"
printfn $"The initial string: '{s}'"
let s2 = s.Replace("a", "b").Replace("b", "c").Replace("c", "d")
printfn $"The final string: '{s2}'"

// The example displays the following output:
//       The initial string: 'aaa'
//       The final string: 'ddd'
Module Example
   Public Sub Main()
      Dim s As String = "aaa"
      Console.WriteLine("The initial string: '{0}'", s)
      s = s.Replace("a", "b").Replace("b", "c").Replace("c", "d")
      Console.WriteLine("The final string: '{0}'", s)
   End Sub
End Module
' The example displays the following output:
'       The initial string: 'aaa'
'       The final string: 'ddd'

Si applica a