String.Replace Método

Definição

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 por String.

Sobrecargas

Replace(Char, Char)

Retorna uma nova cadeia de caracteres na qual todas as ocorrências de um caractere Unicode especificado nessa 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(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 fornecida.

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 diferenciação de maiúsculas e minúsculas.

Replace(Char, Char)

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

Uma cadeia de caracteres equivalente a essa instância, com exceção de 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 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.

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"

Comentários

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

Observação

Este método não altera o valor da instância atual. Em vez disso, ele retorna uma nova cadeia de caracteres na qual todas as ocorrências de oldChar 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

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

Uma cadeia de caracteres equivalente à atual cadeia de caracteres, com exceção de 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 retornará a instância atual inalterada.

Exceções

oldValue é null.

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.

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

Comentários

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

Observação

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

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

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 = "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(String, String, StringComparison)

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 fornecida.

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 dentro desta instância.

Retornos

Uma cadeia de caracteres equivalente à atual cadeia de caracteres, com exceção de 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 retornará a instância atual inalterada.

Exceções

oldValue é null.

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

Comentários

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

Observação

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

Esse método executa uma pesquisa para localizar oldValue usando a cultura e a diferenciação de maiúsculas e minúsculas descrita por comparisonType.

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 = "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

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 diferenciação de maiúsculas e minúsculas.

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; caso contrário, false.

culture
CultureInfo

A cultura a ser usada na comparação. Se culture for null, a cultura atual será usada.

Retornos

Uma cadeia de caracteres equivalente à atual cadeia de caracteres, com exceção de 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 retornará a instância atual inalterada.

Exceções

oldValue é null.

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

Comentários

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

Observação

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

Esse método executa uma pesquisa para localizar oldValue usando a diferenciação de maiúsculas e ignoreCase minúsculas fornecidaculture.

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 = "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