String.Replace String.Replace String.Replace String.Replace Method

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) Replace(String, String, Boolean, CultureInfo) Replace(String, String, Boolean, CultureInfo) Replace(String, String, Boolean, CultureInfo)
Replace(Char, Char) Replace(Char, Char) Replace(Char, Char) 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) Replace(String, String) Replace(String, String) 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) Replace(String, String, StringComparison) Replace(String, String, StringComparison) Replace(String, String, StringComparison)

Replace(String, String, Boolean, CultureInfo) Replace(String, String, Boolean, CultureInfo) Replace(String, String, Boolean, CultureInfo) Replace(String, String, Boolean, CultureInfo)

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

Gibt zurück

Replace(Char, Char) Replace(Char, Char) Replace(Char, Char) 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 Char Char Char

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

newChar
Char Char Char 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 zu oldCharsuchende Ordinalsuche (Groß-/Kleinschreibung und Kultur abhängige Suche) durch.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 oldChar Vorkommen von 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) Replace(String, String) Replace(String, String) 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 String String String

Die zu ersetzende Zeichenfolge.The string to be replaced.

newValue
String String String 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 die leere Zeichenfolge ("").oldValue is the empty string ("").

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie die Replace -Methode verwenden können, um einen Rechtschreibfehler zu korrigieren.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 newValueden Wert oldValue hat, werden alle Vorkommen von entfernt. nullIf 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 oldValue Vorkommen von durch newValueersetzt werden.Instead, it returns a new string in which all occurrences of oldValue are replaced by newValue.

Diese Methode führt eine zu oldValuesuchende Ordinalsuche (Groß-/Kleinschreibung und Kultur abhängige Suche) durch.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) Replace(String, String, StringComparison) Replace(String, String, StringComparison) Replace(String, String, StringComparison)

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

Gibt zurück

Gilt für: