String.Replace Metodo

Definizione

Spazio dei nomi:: System

Assembly:: mscorlib.dll, System.Runtime.dll

Assembly:: netstandard.dll, System.Runtime.dll

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.

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

Overload

Nome	Descrizione
Replace(Char, Char)	Restituisce una nuova stringa in cui tutte le occorrenze di un carattere Unicode specificato 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(Rune, Rune)
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, utilizzando 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, utilizzando le impostazioni cultura e la distinzione tra maiuscole e minuscole specificate.

Replace(Char, Char)

Origine:: String.Manipulation.cs

Origine:: String.Manipulation.cs

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 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 per sostituire tutte le occorrenze di oldChar.

Valori restituiti

String

Stringa equivalente a questa istanza, ad eccezione del 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.

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.

Note

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. Di seguito ne viene illustrato un esempio.

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

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 per sostituire tutte le occorrenze di oldValue.

Valori restituiti

String

Stringa equivalente alla stringa corrente, ad eccezione del 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

ArgumentNullException

oldValue è null.

ArgumentException

oldValue è la stringa vuota ("").

Esempio

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

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, vengono rimosse tutte le occorrenze di oldValue .

Note

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.

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(Rune, Rune)

Origine:: String.Manipulation.cs

public:
 System::String ^ Replace(System::Text::Rune oldRune, System::Text::Rune newRune);

public string Replace(System.Text.Rune oldRune, System.Text.Rune newRune);

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

Public Function Replace (oldRune As Rune, newRune As Rune) As String

Parametri

oldRune: Rune

newRune: Rune

Valori restituiti

String

Si applica a

Replace(String, String, StringComparison)

Origine:: String.Manipulation.cs

Origine:: String.Manipulation.cs

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, utilizzando 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 per sostituire tutte le occorrenze di oldValue.

comparisonType: StringComparison

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

Valori restituiti

String

Eccezioni

ArgumentNullException

oldValue è null.

ArgumentException

oldValue è la stringa vuota ("").

Commenti

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

Note

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.

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

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, utilizzando le impostazioni cultura e la distinzione tra 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 per sostituire tutte le occorrenze di oldValue.

ignoreCase: Boolean

true per ignorare le maiuscole e minuscole durante il confronto; false Altrimenti.

culture: CultureInfo

Impostazioni cultura da usare durante il confronto. Se culture è null, viene utilizzata l'impostazione cultura corrente.

Valori restituiti

String

Eccezioni

ArgumentNullException

oldValue è null.

ArgumentException

oldValue è la stringa vuota ("").

Commenti

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

Note

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

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

Commenti e suggerimenti

Questa pagina è stata utile?