String.Replace Método

Definição

Namespace:: System

Assemblies:: mscorlib.dll, System.Runtime.dll

Assemblies:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Retorna uma nova cadeia de caracteres na qual todas as ocorrências de um caractere Unicode especificado ou String na cadeia de caracteres atual são substituídas por outro caractere Unicode especificado ou String.

Sobrecargas

Nome	Description
Replace(Char, Char)	Retorna uma nova cadeia de caracteres na qual todas as ocorrências de um caractere Unicode especificado nesta instância são substituídas por outro caractere Unicode especificado.
Replace(String, String)	Retorna uma nova cadeia de caracteres na qual todas as ocorrências de uma cadeia de caracteres especificada na instância atual são substituídas por outra cadeia de caracteres especificada.
Replace(Rune, Rune)
Replace(String, String, StringComparison)	Retorna uma nova cadeia de caracteres na qual todas as ocorrências de uma cadeia de caracteres especificada na instância atual são substituídas por outra cadeia de caracteres especificada, usando o tipo de comparação fornecido.
Replace(String, String, Boolean, CultureInfo)	Retorna uma nova cadeia de caracteres na qual todas as ocorrências de uma cadeia de caracteres especificada na instância atual são substituídas por outra cadeia de caracteres especificada, usando a cultura fornecida e a sensibilidade de maiúsculas e minúsculas.

Replace(Char, Char)

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Retorna uma nova cadeia de caracteres na qual todas as ocorrências de um caractere Unicode especificado nesta instância são substituídas por outro caractere 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 caractere Unicode a ser substituído.

newChar: Char

O caractere Unicode para substituir todas as ocorrências de oldChar.

Retornos

String

Uma cadeia de caracteres equivalente a essa instância, exceto que todas as instâncias são oldChar substituídas newCharpor . Se oldChar não for encontrado na instância atual, o método retornará a instância atual inalterada.

Exemplos

O exemplo a seguir cria uma lista de valores separados por vírgulas substituindo vírgulas pelos espaços em branco 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"

Comentários

Esse método executa uma pesquisa ordinal (que diferencia maiúsculas de minúsculas e que não diferencia a cultura) para localizar oldChar.

Note

Esse método não modifica o valor da instância atual. Em vez disso, retorna uma nova cadeia de oldChar caracteres na qual todas as ocorrências são substituídas por newChar.

Como esse método retorna a cadeia de caracteres modificada, você pode encadear chamadas sucessivas ao Replace método para executar várias substituições na cadeia de caracteres original. As chamadas de método são executadas da esquerda para a direita. O exemplo a seguir ilustra esse cenário.

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'

Confira 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

Retorna uma nova cadeia de caracteres na qual todas as ocorrências de uma cadeia de caracteres especificada na instância atual são substituídas por outra cadeia de caracteres 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 de caracteres para substituir todas as ocorrências de oldValue.

Retornos

String

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

Exceções

ArgumentNullException

oldValue é null.

ArgumentException

oldValue é a cadeia de caracteres vazia ("").

Exemplos

O exemplo a seguir demonstra como você pode usar o Replace método para corrigir um erro de ortografia.

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

Comentários

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

Note

Esse método não modifica o valor da instância atual. Em vez disso, retorna uma nova cadeia de oldValue caracteres na qual todas as ocorrências são substituídas por newValue.

Esse método executa uma pesquisa ordinal (que diferencia maiúsculas de minúsculas e que não diferencia a cultura) para localizar 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'

Confira 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

Retornos

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

Retorna uma nova cadeia de caracteres na qual todas as ocorrências de uma cadeia de caracteres especificada na instância atual são substituídas por outra cadeia de caracteres 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 de caracteres para substituir todas as ocorrências de oldValue.

comparisonType: StringComparison

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

Retornos

String

Exceções

ArgumentNullException

oldValue é null.

ArgumentException

oldValue é a cadeia de caracteres vazia ("").

Comentários

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

Note

Esse método não modifica o valor da instância atual. Em vez disso, retorna uma nova cadeia de oldValue caracteres na qual todas as ocorrências são substituídas por newValue.

Esse método executa uma pesquisa para localizar oldValue usando a cultura e a confidencialidade de maiúsculas e minúsculas descrita 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

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 de caracteres para substituir todas as ocorrências de oldValue.

ignoreCase: Boolean

true para ignorar maiúsculas e minúsculas ao comparar; false Caso contrário.

culture: CultureInfo

A cultura a ser usada ao comparar. Se culture for null, a cultura atual será usada.

Retornos

String

Exceções

ArgumentNullException

oldValue é null.

ArgumentException

oldValue é a cadeia de caracteres vazia ("").

Comentários

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

Note

Esse método não modifica o valor da instância atual. Em vez disso, retorna uma nova cadeia de oldValue caracteres na qual todas as ocorrências são substituídas por newValue.

Esse método executa uma pesquisa para localizar oldValue usando a confidencialidade de maiúsculas e culture minúsculas fornecidaignoreCase.

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?