Číst v angličtině

Sdílet prostřednictvím


String.Replace Metoda

Definice

Vrátí nový řetězec, ve kterém jsou všechny výskyty zadaného znaku Unicode nebo String v aktuálním řetězci nahrazeny jiným zadaným znakem Unicode nebo String.

Přetížení

Replace(Char, Char)

Vrátí nový řetězec, ve kterém jsou všechny výskyty zadaného znaku Unicode v této instanci nahrazeny jiným zadaným znakem Unicode.

Replace(String, String)

Vrátí nový řetězec, ve kterém jsou všechny výskyty zadaného řetězce v aktuální instanci nahrazeny jiným zadaným řetězcem.

Replace(String, String, StringComparison)

Vrátí nový řetězec, ve kterém jsou všechny výskyty zadaného řetězce v aktuální instanci nahrazeny jiným zadaným řetězcem pomocí zadaného typu porovnání.

Replace(String, String, Boolean, CultureInfo)

Vrátí nový řetězec, ve kterém jsou všechny výskyty zadaného řetězce v aktuální instanci nahrazeny jiným zadaným řetězcem s použitím zadané jazykové verze a rozlišování velkých a malých písmen.

Replace(Char, Char)

Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs

Vrátí nový řetězec, ve kterém jsou všechny výskyty zadaného znaku Unicode v této instanci nahrazeny jiným zadaným znakem Unicode.

public string Replace (char oldChar, char newChar);

Parametry

oldChar
Char

Znak unicode, který má být nahrazen.

newChar
Char

Znak Unicode, který nahradí všechny výskyty znaku oldChar.

Návraty

Řetězec, který je ekvivalentní této instanci kromě toho, že všechny instance jsou oldChar nahrazeny za newChar. Pokud oldChar se v aktuální instanci nenajde, vrátí metoda aktuální instanci beze změny.

Příklady

Následující příklad vytvoří seznam hodnot oddělených čárkami nahrazením mezer mezi řadou čísel.

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"

Poznámky

Tato metoda provede ordinální vyhledávání (rozlišují se malá a velká písmena a nerozlišují jazykovou verzi) a vyhledá oldChar.

Poznámka

Tato metoda neupravuje hodnotu aktuální instance. Místo toho vrátí nový řetězec, ve kterém jsou všechny výskyty nahrazeny oldChar řetězcem newChar.

Vzhledem k tomu, že tato metoda vrátí změněný řetězec, můžete zřetězovat Replace po sobě jdoucí volání metody provést více nahrazení původního řetězce. Volání metody se provádí zleva doprava. V následujícím příkladu je uvedena ukázka.

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'

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Replace(String, String)

Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs

Vrátí nový řetězec, ve kterém jsou všechny výskyty zadaného řetězce v aktuální instanci nahrazeny jiným zadaným řetězcem.

public string Replace (string oldValue, string newValue);
public string Replace (string oldValue, string? newValue);

Parametry

oldValue
String

Řetězec, který má být nahrazen.

newValue
String

Řetězec, který má nahradit všechny výskyty .oldValue

Návraty

Řetězec, který je ekvivalentní aktuálnímu řetězci s tím rozdílem, že všechny instance jsou nahrazeny oldValue za newValue. Pokud oldValue se v aktuální instanci nenajde, vrátí metoda aktuální instanci beze změny.

Výjimky

oldValue je null.

oldValue je prázdný řetězec ("").

Příklady

Následující příklad ukazuje, jak můžete použít metodu Replace k opravě pravopisné chyby.

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

Poznámky

Pokud newValue je null, odeberou se všechny výskyty oldValue .

Poznámka

Tato metoda neupravuje hodnotu aktuální instance. Místo toho vrátí nový řetězec, ve kterém jsou všechny výskyty nahrazeny oldValue řetězcem newValue.

Tato metoda provede ordinální vyhledávání (rozlišují se malá a velká písmena a nerozlišují jazykovou verzi) a vyhledá oldValue.

Vzhledem k tomu, že tato metoda vrátí změněný řetězec, můžete zřetězovat Replace po sobě jdoucí volání metody provést více nahrazení původního řetězce. Volání metody se provádí zleva doprava. V následujícím příkladu je uvedena ukázka.

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'

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Replace(String, String, StringComparison)

Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs

Vrátí nový řetězec, ve kterém jsou všechny výskyty zadaného řetězce v aktuální instanci nahrazeny jiným zadaným řetězcem pomocí zadaného typu porovnání.

public string Replace (string oldValue, string? newValue, StringComparison comparisonType);
public string Replace (string oldValue, string newValue, StringComparison comparisonType);

Parametry

oldValue
String

Řetězec, který má být nahrazen.

newValue
String

Řetězec, který má nahradit všechny výskyty .oldValue

comparisonType
StringComparison

Jedna z hodnot výčtu, která určuje, jak oldValue je prohledána v rámci této instance.

Návraty

Řetězec, který je ekvivalentní aktuálnímu řetězci s tím rozdílem, že všechny instance jsou nahrazeny oldValue za newValue. Pokud oldValue se v aktuální instanci nenajde, vrátí metoda aktuální instanci beze změny.

Výjimky

oldValue je null.

oldValue je prázdný řetězec ("").

Poznámky

Pokud newValue je null, odeberou se všechny výskyty oldValue .

Poznámka

Tato metoda neupravuje hodnotu aktuální instance. Místo toho vrátí nový řetězec, ve kterém jsou všechny výskyty nahrazeny oldValue řetězcem newValue.

Tato metoda provádí hledání pomocí oldValue jazykové verze a rozlišování velkých a malých písmen popsaných v comparisonType.

Vzhledem k tomu, že tato metoda vrátí změněný řetězec, můžete zřetězovat Replace po sobě jdoucí volání metody provést více nahrazení původního řetězce. Volání metody se provádí zleva doprava. V následujícím příkladu je uvedena ukázka.

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'

Platí pro

.NET 9 a další verze
Produkt Verze
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

Replace(String, String, Boolean, CultureInfo)

Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs
Zdroj:
String.Manipulation.cs

Vrátí nový řetězec, ve kterém jsou všechny výskyty zadaného řetězce v aktuální instanci nahrazeny jiným zadaným řetězcem s použitím zadané jazykové verze a rozlišování velkých a malých písmen.

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);

Parametry

oldValue
String

Řetězec, který má být nahrazen.

newValue
String

Řetězec, který má nahradit všechny výskyty .oldValue

ignoreCase
Boolean

true ignorovat při porovnávání velikostí a malých a malých velikostí; false Jinak.

culture
CultureInfo

Jazyková verze, která se má použít při porovnávání. Pokud culture je null, použije se aktuální jazyková verze.

Návraty

Řetězec, který je ekvivalentní aktuálnímu řetězci s tím rozdílem, že všechny instance jsou nahrazeny oldValue za newValue. Pokud oldValue se v aktuální instanci nenajde, vrátí metoda aktuální instanci beze změny.

Výjimky

oldValue je null.

oldValue je prázdný řetězec ("").

Poznámky

Pokud newValue je null, odeberou se všechny výskyty oldValue .

Poznámka

Tato metoda neupravuje hodnotu aktuální instance. Místo toho vrátí nový řetězec, ve kterém jsou všechny výskyty nahrazeny oldValue řetězcem newValue.

Tato metoda provádí hledání pomocí oldValue zadaných culture a ignoreCase rozlišování velkých a malých písmen.

Vzhledem k tomu, že tato metoda vrátí změněný řetězec, můžete zřetězovat Replace po sobě jdoucí volání metody provést více nahrazení původního řetězce. Volání metody se provádí zleva doprava. V následujícím příkladu je uvedena ukázka.

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'

Platí pro

.NET 9 a další verze
Produkt Verze
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1