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.Returns a new string in which all occurrences of a specified Unicode character or String in the current string are replaced with another specified Unicode character or String.

Überlädt

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.Returns a new string in which all occurrences of a specified string in the current instance are replaced with another specified string, using the provided culture and case sensitivity.

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.Returns a new string in which all occurrences of a specified Unicode character in this instance are replaced with another specified Unicode character.

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.Returns a new string in which all occurrences of a specified string in the current instance are replaced with another specified string.

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.Returns a new string in which all occurrences of a specified string in the current instance are replaced with another specified string, using the provided comparison type.

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.Returns a new string in which all occurrences of a specified string in the current instance are replaced with another specified string, using the provided culture and case sensitivity.

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

Parameter

oldValue
String

Die zu ersetzende Zeichenfolge.The string to be replaced.

newValue
String

Die Zeichenfolge, die jedes Vorkommen von oldValue ersetzen soll.The string to replace all occurrences of oldValue.

ignoreCase
Boolean

true, um die Groß-/Kleinschreibung beim Vergleich zu ignorieren, andernfalls false.true to ignore casing when comparing; false otherwise.

culture
CultureInfo

Die Kultur, die beim Vergleich verwendet werden soll.The culture to use when comparing.

Gibt zurück

Eine Zeichenfolge, die der aktuellen Zeichenfolge entspricht, außer dass alle Instanzen von oldValue durch newValue ersetzt werden.A string that is equivalent to the current string except that all instances of oldValue are replaced with newValue. Wenn oldValue nicht in der aktuellen Instanz gefunden wird, gibt die Methode die aktuelle Instanz unverändert zurück.If oldValue is not found in the current instance, the method returns the current instance unchanged.

Ausnahmen

oldValue ist null.oldValue is null.

oldValue ist die leere Zeichenfolge ("").oldValue is the empty string ("").

Hinweise

Wenn newValue nullist, werden alle Vorkommen von oldValue entfernt.If newValue is null, all occurrences of oldValue are removed.

Hinweis

Diese Methode ändert nicht den Wert der aktuellen Instanz.This method does not modify the value of the current instance. Stattdessen wird eine neue Zeichenfolge zurückgegeben, in der alle Vorkommen von oldValue durch newValueersetzt werden.Instead, it returns a new string in which all occurrences of oldValue are replaced by newValue.

Diese Methode führt eine Suche durch, um oldValue mithilfe der angegebenen culture und ignoreCase Groß-/Kleinschreibung zu suchen.This method performs a search to find oldValue using the provided culture and ignoreCase case sensitivity.

Da diese Methode die geänderte Zeichenfolge zurückgibt, können Sie aufeinander folgende Aufrufe der Replace-Methode verketten, um mehrere Ersetzungen in der ursprünglichen Zeichenfolge auszuführen.Because this method returns the modified string, you can chain together successive calls to the Replace method to perform multiple replacements on the original string. Methodenaufrufe werden von links nach rechts ausgeführt.Method calls are executed from left to right. Dies wird im folgenden Beispiel veranschaulicht.The following example provides an illustration.

String s = "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);

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

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.Returns a new string in which all occurrences of a specified Unicode character in this instance are replaced with another specified Unicode character.

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

Parameter

oldChar
Char

Das zu ersetzende Unicode-Zeichen.The Unicode character to be replaced.

newChar
Char

Das Unicode-Zeichen, das jedes Vorkommen von oldChar ersetzen soll.The Unicode character to replace all occurrences of oldChar.

Gibt zurück

Eine Zeichenfolge, die dieser Instanz entspricht, außer dass alle Instanzen von oldChar durch newChar ersetzt werden.A string that is equivalent to this instance except that all instances of oldChar are replaced with newChar. Wenn oldChar nicht in der aktuellen Instanz gefunden wird, gibt die Methode die aktuelle Instanz unverändert zurück.If oldChar is not found in the current instance, the method returns the current instance unchanged.

Beispiele

Im folgenden Beispiel wird eine durch Kommas getrennte Liste erstellt, indem die Leerzeichen zwischen einer Reihe von Zahlen durch Kommas ersetzt werden.The following example creates a comma separated value list by substituting commas for the blanks between a series of numbers.

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: \"{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"
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"

Hinweise

Diese Methode führt eine Ordinalsuche (Groß-/Kleinschreibung und Kultur abhängige Suche) durch, um nach oldCharzu suchen.This method performs an ordinal (case-sensitive and culture-insensitive) search to find oldChar.

Hinweis

Diese Methode ändert nicht den Wert der aktuellen Instanz.This method does not modify the value of the current instance. Stattdessen wird eine neue Zeichenfolge zurückgegeben, in der alle Vorkommen von oldChar durch newCharersetzt werden.Instead, it returns a new string in which all occurrences of oldChar are replaced by newChar.

Da diese Methode die geänderte Zeichenfolge zurückgibt, können Sie aufeinander folgende Aufrufe der Replace-Methode verketten, um mehrere Ersetzungen in der ursprünglichen Zeichenfolge auszuführen.Because this method returns the modified string, you can chain together successive calls to the Replace method to perform multiple replacements on the original string. Methodenaufrufe werden von links nach rechts ausgeführt.Method calls are executed from left to right. Dies wird im folgenden Beispiel veranschaulicht.The following example provides an illustration.

String s = new String('a', 3);
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);

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

Siehe auch

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.Returns a new string in which all occurrences of a specified string in the current instance are replaced with another specified string.

public:
 System::String ^ Replace(System::String ^ oldValue, System::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

Parameter

oldValue
String

Die zu ersetzende Zeichenfolge.The string to be replaced.

newValue
String

Die Zeichenfolge, die jedes Vorkommen von oldValue ersetzen soll.The string to replace all occurrences of oldValue.

Gibt zurück

Eine Zeichenfolge, die der aktuellen Zeichenfolge entspricht, außer dass alle Instanzen von oldValue durch newValue ersetzt werden.A string that is equivalent to the current string except that all instances of oldValue are replaced with newValue. Wenn oldValue nicht in der aktuellen Instanz gefunden wird, gibt die Methode die aktuelle Instanz unverändert zurück.If oldValue is not found in the current instance, the method returns the current instance unchanged.

Ausnahmen

oldValue ist null.oldValue is null.

oldValue ist die leere Zeichenfolge ("").oldValue is the empty string ("").

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie mit der Replace-Methode einen Rechtschreibfehler korrigieren können.The following example demonstrates how you can use the Replace method to correct a spelling error.

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:{0}'{1}'{0}", Environment.NewLine, errString);

// Correct the spelling of "document".

string correctString = errString.Replace("docment", "document");

Console.WriteLine("After correcting the string, the result is:{0}'{1}'",
        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'
'

Hinweise

Wenn newValue nullist, werden alle Vorkommen von oldValue entfernt.If newValue is null, all occurrences of oldValue are removed.

Hinweis

Diese Methode ändert nicht den Wert der aktuellen Instanz.This method does not modify the value of the current instance. Stattdessen wird eine neue Zeichenfolge zurückgegeben, in der alle Vorkommen von oldValue durch newValueersetzt werden.Instead, it returns a new string in which all occurrences of oldValue are replaced by newValue.

Diese Methode führt eine Ordinalsuche (Groß-/Kleinschreibung und Kultur abhängige Suche) durch, um nach oldValuezu suchen.This method performs an ordinal (case-sensitive and culture-insensitive) search to find oldValue.

Da diese Methode die geänderte Zeichenfolge zurückgibt, können Sie aufeinander folgende Aufrufe der Replace-Methode verketten, um mehrere Ersetzungen in der ursprünglichen Zeichenfolge auszuführen.Because this method returns the modified string, you can chain together successive calls to the Replace method to perform multiple replacements on the original string. Methodenaufrufe werden von links nach rechts ausgeführt.Method calls are executed from left to right. Dies wird im folgenden Beispiel veranschaulicht.The following example provides an illustration.

String s = "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);

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

Siehe auch

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.Returns a new string in which all occurrences of a specified string in the current instance are replaced with another specified string, using the provided comparison type.

public:
 System::String ^ Replace(System::String ^ oldValue, System::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

Parameter

oldValue
String

Die zu ersetzende Zeichenfolge.The string to be replaced.

newValue
String

Die Zeichenfolge, die jedes Vorkommen von oldValue ersetzen soll.The string to replace all occurrences of oldValue.

comparisonType
StringComparison

Einer der Enumerationswerte, der bestimmt, wie oldValue in dieser Instanz gesucht werden soll.One of the enumeration values that determines how oldValue is searched within this instance.

Gibt zurück

Eine Zeichenfolge, die der aktuellen Zeichenfolge entspricht, außer dass alle Instanzen von oldValue durch newValue ersetzt werden.A string that is equivalent to the current string except that all instances of oldValue are replaced with newValue. Wenn oldValue nicht in der aktuellen Instanz gefunden wird, gibt die Methode die aktuelle Instanz unverändert zurück.If oldValue is not found in the current instance, the method returns the current instance unchanged.

Ausnahmen

oldValue ist null.oldValue is null.

oldValue ist die leere Zeichenfolge ("").oldValue is the empty string ("").

Hinweise

Wenn newValue nullist, werden alle Vorkommen von oldValue entfernt.If newValue is null, all occurrences of oldValue are removed.

Hinweis

Diese Methode ändert nicht den Wert der aktuellen Instanz.This method does not modify the value of the current instance. Stattdessen wird eine neue Zeichenfolge zurückgegeben, in der alle Vorkommen von oldValue durch newValueersetzt werden.Instead, it returns a new string in which all occurrences of oldValue are replaced by newValue.

Diese Methode führt eine Suche durch, um oldValue anhand der Kultur und der Groß-/Kleinschreibung durch comparisonTypezu finden.This method performs a search to find oldValue using the culture and case sensitivity described by comparisonType.

Da diese Methode die geänderte Zeichenfolge zurückgibt, können Sie aufeinander folgende Aufrufe der Replace-Methode verketten, um mehrere Ersetzungen in der ursprünglichen Zeichenfolge auszuführen.Because this method returns the modified string, you can chain together successive calls to the Replace method to perform multiple replacements on the original string. Methodenaufrufe werden von links nach rechts ausgeführt.Method calls are executed from left to right. Dies wird im folgenden Beispiel veranschaulicht.The following example provides an illustration.

String s = "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);

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

Gilt für: