Substituição de string C#

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:

• oldValuerepresenta a substring a ser substituída.
• newValuerepresenta a substring de substituição.

O Replace()método retorna uma nova string com todas as ocorrências de oldValuesubstituí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 byeLinguagem de código:  C#  ( cs )

Observe que o Replace()não modifica a string original, ele retorna uma nova string com a substring oldValuesubstituí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, comparisonTypeaceita um dos membros do StringComparisonenum que especifica a regra que o método usa para corresponder à oldValuestring.

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 ByeLinguagem de código:  C#  ( cs )

Resumo

• Use o método C# String Replace()para substituir uma substring em uma string por uma nova substring.