String.Replace Método

Definição

Espaço de Nomes:: System

Assemblagens:: mscorlib.dll, System.Runtime.dll

Assemblagens:: netstandard.dll, System.Runtime.dll

Assemblagem:: System.Runtime.dll

Assemblagem:: mscorlib.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Devolve uma nova cadeia em que todas as ocorrências de um carácter Unicode especificado ou String na cadeia atual são substituídas por outro carácter Unicode especificado ou String.

Sobrecargas

Name	Description
Replace(Char, Char)	Devolve uma nova cadeia em que todas as ocorrências de um carácter Unicode especificado neste caso são substituídas por outro carácter Unicode especificado.
Replace(String, String)	Devolve uma nova cadeia em que todas as ocorrências de uma cadeia especificada na instância atual são substituídas por outra cadeia especificada.
Replace(Rune, Rune)
Replace(String, String, StringComparison)	Devolve uma nova cadeia em que todas as ocorrências de uma cadeia especificada na instância atual são substituídas por outra cadeia especificada, usando o tipo de comparação fornecido.
Replace(String, String, Boolean, CultureInfo)	Devolve uma nova cadeia em que todas as ocorrências de uma cadeia especificada na instância atual são substituídas por outra cadeia especificada, usando a cultura e a sensibilidade a maiúsculas e minúsculas fornecidas.

Replace(Char, Char)

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Devolve uma nova cadeia em que todas as ocorrências de um carácter Unicode especificado neste caso são substituídas por outro carácter Unicode especificado.

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

Parâmetros

oldChar: Char

O carácter Unicode a ser substituído.

newChar: Char

O carácter Unicode para substituir todas as ocorrências de oldChar.

Devoluções

String

Uma cadeia que é equivalente a esta instância, exceto que todas as instâncias de oldChar são substituídas por newChar. Se oldChar não for encontrado na instância atual, o método devolve a instância atual inalterada.

Exemplos

O exemplo seguinte cria uma lista de valores separados por vírgulas ao substituir as vírgulas pelos espaços entre uma série de números.

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"

Observações

Este método realiza uma pesquisa ordinal (sensível a maiúsculas e minúsculas e insensíveis à cultura) para encontrar oldChar.

Note

Este método não modifica o valor da instância atual. Em vez disso, devolve uma nova cadeia em que todas as ocorrências de oldChar são substituídas por newChar.

Como este método devolve a cadeia modificada, pode encadear chamadas sucessivas ao Replace método para realizar múltiplas substituições na cadeia original. As chamadas de método são executadas da esquerda para a direita. O exemplo a seguir fornece uma ilustração.

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'

Ver também

Aplica-se a

Replace(String, String)

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Devolve uma nova cadeia em que todas as ocorrências de uma cadeia especificada na instância atual são substituídas por outra cadeia especificada.

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

Parâmetros

oldValue: String

A cadeia de caracteres a ser substituída.

newValue: String

A cadeia para substituir todas as ocorrências de oldValue.

Devoluções

String

Uma cadeia que é equivalente à cadeia atual, exceto que todas as instâncias de oldValue são substituídas por newValue. Se oldValue não for encontrado na instância atual, o método devolve a instância atual inalterada.

Exceções

ArgumentNullException

oldValue é null.

ArgumentException

oldValue é a corda vazia ("").

Exemplos

O exemplo seguinte demonstra como pode usar o Replace método para corrigir um erro ortográfico.

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'
'

Observações

Se newValue for null, todas as ocorrências de oldValue são removidas.

Note

Este método não modifica o valor da instância atual. Em vez disso, devolve uma nova cadeia em que todas as ocorrências de oldValue são substituídas por newValue.

Este método realiza uma pesquisa ordinal (sensível a maiúsculas e minúsculas e insensíveis à cultura) para encontrar 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'

Ver também

Aplica-se a

Replace(Rune, Rune)

Origem:: 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

Parâmetros

oldRune: Rune

newRune: Rune

Devoluções

String

Aplica-se a

Replace(String, String, StringComparison)

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Devolve uma nova cadeia em que todas as ocorrências de uma cadeia especificada na instância atual são substituídas por outra cadeia especificada, usando o tipo de comparação fornecido.

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

Parâmetros

oldValue: String

A cadeia de caracteres a ser substituída.

newValue: String

A cadeia para substituir todas as ocorrências de oldValue.

comparisonType: StringComparison

Um dos valores de enumeração que determina como oldValue é pesquisado nesta instância.

Devoluções

String

Exceções

ArgumentNullException

oldValue é null.

ArgumentException

oldValue é a corda vazia ("").

Observações

Se newValue for null, todas as ocorrências de oldValue são removidas.

Note

Este método não modifica o valor da instância atual. Em vez disso, devolve uma nova cadeia em que todas as ocorrências de oldValue são substituídas por newValue.

Este método realiza uma pesquisa para encontrar oldValue usando a sensibilidade à cultura e ao maiúsculo descritos por 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'

Aplica-se a

Replace(String, String, Boolean, CultureInfo)

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Devolve uma nova cadeia em que todas as ocorrências de uma cadeia especificada na instância atual são substituídas por outra cadeia especificada, usando a cultura e a sensibilidade a maiúsculas e minúsculas fornecidas.

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

Parâmetros

oldValue: String

A cadeia de caracteres a ser substituída.

newValue: String

A cadeia para substituir todas as ocorrências de oldValue.

ignoreCase: Boolean

true ignorar a carcaça ao comparar; false caso contrário.

culture: CultureInfo

A cultura a usar para comparar. Se culture for igual a null, a cultura atual é usada.

Devoluções

String

Exceções

ArgumentNullException

oldValue é null.

ArgumentException

oldValue é a corda vazia ("").

Observações

Se newValue for null, todas as ocorrências de oldValue são removidas.

Note

Este método não modifica o valor da instância atual. Em vez disso, devolve uma nova cadeia em que todas as ocorrências de oldValue são substituídas por newValue.

Este método realiza uma pesquisa para encontrar oldValue usando a sensibilidade fornecida culture e ignoreCase maiúscula e minúscula.

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'

Aplica-se a

Comentários

Esta página foi útil?