Resumo : neste tutorial, você aprenderá como usar o Replace()
método C# String para substituir todas as ocorrências de uma substring especificada em uma string por uma nova substring.
Introdução ao método C# String Replace()
O método String Replace()
permite substituir todas as ocorrências de uma substring em uma string por uma nova substring. O Replace()
método possui diversas sobrecargas que permitem customizar as operações de substituição.
Aqui está a sintaxe básica do Replace()
método:
public string Replace(
string oldValue,
string newValue
)
Linguagem de código: C# ( cs )
O Replace()
método leva dois parâmetros:
oldValue
representa a substring a ser substituída.newValue
representa a substring de substituição.
O Replace()
método retorna uma nova string com todas as ocorrências de oldValue
substituídas por newValue
.
O exemplo a seguir mostra como usar o Replace()
método para substituir a substring "hi"
pela nova substring "bye"
na string "hi hi hi"
:
using static System.Console;
var message = "hi hi hi";
var newMessage = message.Replace("hi", "bye");
WriteLine(newMessage);
Linguagem de código: C# ( cs )
Saída:
bye bye bye
Linguagem de código: C# ( cs )
Observe que o Replace()
não modifica a string original, ele retorna uma nova string com a substring oldValue
substituída pela nova substring newValue
.
Por padrão, o Replace()
método corresponde à string diferenciando maiúsculas de minúsculas. Para especificar uma regra para corresponder a string antes da substituição, você pode usar a seguinte sobrecarga do Replace()
método:
public string Replace (
string oldValue,
string? newValue,
StringComparison comparisonType
);
Linguagem de código: C# ( cs )
Neste método, comparisonType
aceita um dos membros do StringComparison
enum que especifica a regra que o método usa para corresponder à oldValue
string.
Por exemplo, o programa a seguir usa o Replace()
método que usa a regra ordinal de ignorar caso para substituir a substring "Hi"
pela nova substring "Bye"
na string "Hi hi hi"
:
using static System.Console;
var message = "Hi hi hi";
var newMessage = message.Replace(
"Hi",
"Bye",
StringComparison.OrdinalIgnoreCase
);
WriteLine(newMessage);
Linguagem de código: C# ( cs )
Saída:
Bye Bye Bye
Linguagem de código: C# ( cs )
Resumo
- Use o método C# String
Replace()
para substituir uma substring em uma string por uma nova substring.