Auf Englisch lesen

Freigeben über


String.Replace Methode

Definition

Gibt eine neue Zeichenfolge zurück, in der alle Vorkommen von einem angegebenen Unicode-Zeichen oder String in der aktuellen Zeichenfolge durch ein anderes angegebenes Unicode-Zeichen oder einen anderen String ersetzt werden.

Überlädt

Replace(Char, Char)

Gibt eine neue Zeichenfolge zurück, in der alle Vorkommen eines angegebenen Unicode-Zeichens in dieser Instanz durch ein anderes angegebenes Unicode-Zeichen ersetzt wurden.

Replace(String, String)

Gibt eine neue Zeichenfolge zurück, in der alle Vorkommen einer angegebenen Zeichenfolge in der aktuellen Instanz durch eine andere angegebene Zeichenfolge ersetzt wurden.

Replace(String, String, StringComparison)

Gibt mithilfe des bereitgestellten Vergleichstyps eine neue Zeichenfolge zurück, in der alle Vorkommen einer angegebenen Zeichenfolge in der aktuellen Instanz durch eine andere angegebene Zeichenfolge ersetzt wurden.

Replace(String, String, Boolean, CultureInfo)

Gibt mithilfe der angegebenen Kultur und der Angabe zur Groß-/Kleinschreibung eine neue Zeichenfolge zurück, in der alle Vorkommen einer angegebenen Zeichenfolge in der aktuellen Instanz durch eine andere angegebene Zeichenfolge ersetzt wurden.

Replace(Char, Char)

Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs

Gibt eine neue Zeichenfolge zurück, in der alle Vorkommen eines angegebenen Unicode-Zeichens in dieser Instanz durch ein anderes angegebenes Unicode-Zeichen ersetzt wurden.

public string Replace (char oldChar, char newChar);

Parameter

oldChar
Char

Das zu ersetzende Unicode-Zeichen.

newChar
Char

Das Unicode-Zeichen, das jedes Vorkommen von oldChar ersetzen soll.

Gibt zurück

Eine Zeichenfolge, die dieser Instanz entspricht, außer dass alle Instanzen von oldChar durch newChar ersetzt werden. Wenn oldChar nicht in der aktuellen Instanz gefunden wird, gibt die Methode die aktuelle Instanz unverändert zurück.

Beispiele

Im folgenden Beispiel wird eine durch Kommas getrennte Wertliste erstellt, indem die Leerzeichen durch Kommas zwischen einer Zahlenreihe ersetzt werden.

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"

Hinweise

Diese Methode führt eine Ordnungssuche (groß- und kulturunabhängig) durch, um nach zu suchen oldChar.

Hinweis

Diese Methode ändert den Wert des aktuellen instance nicht. Stattdessen wird eine neue Zeichenfolge zurückgegeben, in der alle Vorkommen von oldChar durch newCharersetzt werden.

Da diese Methode die geänderte Zeichenfolge zurückgibt, können Sie aufeinander folgende Aufrufe der Replace -Methode verketten, um mehrere Ersetzungen für die ursprüngliche Zeichenfolge durchzuführen. Methodenaufrufe werden von links nach rechts ausgeführt. Dies wird im folgenden Beispiel veranschaulicht.

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'

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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)

Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs

Gibt eine neue Zeichenfolge zurück, in der alle Vorkommen einer angegebenen Zeichenfolge in der aktuellen Instanz durch eine andere angegebene Zeichenfolge ersetzt wurden.

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

Parameter

oldValue
String

Die zu ersetzende Zeichenfolge.

newValue
String

Die Zeichenfolge, die jedes Vorkommen von oldValue ersetzen soll.

Gibt zurück

Eine Zeichenfolge, die der aktuellen Zeichenfolge entspricht, außer dass alle Instanzen von oldValue durch newValue ersetzt werden. Wenn oldValue nicht in der aktuellen Instanz gefunden wird, gibt die Methode die aktuelle Instanz unverändert zurück.

Ausnahmen

oldValue ist null.

oldValue ist die leere Zeichenfolge ("").

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie die Replace -Methode verwenden können, um einen Rechtschreibfehler zu korrigieren.

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

Hinweise

Wenn newValue ist null, werden alle Vorkommen von oldValue entfernt.

Hinweis

Diese Methode ändert den Wert des aktuellen instance nicht. Stattdessen wird eine neue Zeichenfolge zurückgegeben, in der alle Vorkommen von oldValue durch newValueersetzt werden.

Diese Methode führt eine Ordnungssuche (groß- und kulturunabhängig) durch, um nach zu suchen oldValue.

Da diese Methode die geänderte Zeichenfolge zurückgibt, können Sie aufeinander folgende Aufrufe der Replace -Methode verketten, um mehrere Ersetzungen für die ursprüngliche Zeichenfolge durchzuführen. Methodenaufrufe werden von links nach rechts ausgeführt. Dies wird im folgenden Beispiel veranschaulicht.

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'

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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)

Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs

Gibt mithilfe des bereitgestellten Vergleichstyps eine neue Zeichenfolge zurück, in der alle Vorkommen einer angegebenen Zeichenfolge in der aktuellen Instanz durch eine andere angegebene Zeichenfolge ersetzt wurden.

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

Parameter

oldValue
String

Die zu ersetzende Zeichenfolge.

newValue
String

Die Zeichenfolge, die jedes Vorkommen von oldValue ersetzen soll.

comparisonType
StringComparison

Einer der Enumerationswerte, der bestimmt, wie oldValue in dieser Instanz gesucht werden soll.

Gibt zurück

Eine Zeichenfolge, die der aktuellen Zeichenfolge entspricht, außer dass alle Instanzen von oldValue durch newValue ersetzt werden. Wenn oldValue nicht in der aktuellen Instanz gefunden wird, gibt die Methode die aktuelle Instanz unverändert zurück.

Ausnahmen

oldValue ist null.

oldValue ist die leere Zeichenfolge ("").

Hinweise

Wenn newValue ist null, werden alle Vorkommen von oldValue entfernt.

Hinweis

Diese Methode ändert den Wert des aktuellen instance nicht. Stattdessen wird eine neue Zeichenfolge zurückgegeben, in der alle Vorkommen von oldValue durch newValueersetzt werden.

Diese Methode führt eine Suche nach der oldValue Kultur und Groß-/Kleinschreibung durch, die von beschrieben wird comparisonType.

Da diese Methode die geänderte Zeichenfolge zurückgibt, können Sie aufeinander folgende Aufrufe der Replace -Methode verketten, um mehrere Ersetzungen für die ursprüngliche Zeichenfolge durchzuführen. Methodenaufrufe werden von links nach rechts ausgeführt. Dies wird im folgenden Beispiel veranschaulicht.

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'

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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)

Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs

Gibt mithilfe der angegebenen Kultur und der Angabe zur Groß-/Kleinschreibung eine neue Zeichenfolge zurück, in der alle Vorkommen einer angegebenen Zeichenfolge in der aktuellen Instanz durch eine andere angegebene Zeichenfolge ersetzt wurden.

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

Parameter

oldValue
String

Die zu ersetzende Zeichenfolge.

newValue
String

Die Zeichenfolge, die jedes Vorkommen von oldValue ersetzen soll.

ignoreCase
Boolean

true, um die Groß-/Kleinschreibung beim Vergleich zu ignorieren, andernfalls false.

culture
CultureInfo

Die Kultur, die beim Vergleich verwendet werden soll. Wenn culturenull ist, wird die aktuelle Kultur verwendet.

Gibt zurück

Eine Zeichenfolge, die der aktuellen Zeichenfolge entspricht, außer dass alle Instanzen von oldValue durch newValue ersetzt werden. Wenn oldValue nicht in der aktuellen Instanz gefunden wird, gibt die Methode die aktuelle Instanz unverändert zurück.

Ausnahmen

oldValue ist null.

oldValue ist die leere Zeichenfolge ("").

Hinweise

Wenn newValue ist null, werden alle Vorkommen von oldValue entfernt.

Hinweis

Diese Methode ändert den Wert des aktuellen instance nicht. Stattdessen wird eine neue Zeichenfolge zurückgegeben, in der alle Vorkommen von oldValue durch newValueersetzt werden.

Diese Methode führt eine Suche oldValue nach der angegebenen culture Und Groß-/ ignoreCase Kleinschreibung durch.

Da diese Methode die geänderte Zeichenfolge zurückgibt, können Sie aufeinander folgende Aufrufe der Replace -Methode verketten, um mehrere Ersetzungen für die ursprüngliche Zeichenfolge durchzuführen. Methodenaufrufe werden von links nach rechts ausgeführt. Dies wird im folgenden Beispiel veranschaulicht.

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'

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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