StringBuilder.Replace Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ersetzt alle Vorkommen eines angegebenen Zeichens bzw. einer angegebenen Zeichenfolge in dieser Instanz durch ein anderes Zeichen bzw. eine andere Zeichenfolge.
Überlädt
Replace(Char, Char) |
Ersetzt in dieser Instanz alle Vorkommen eines angegebenen Zeichens durch ein anderes angegebenes Zeichen. |
Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>) | |
Replace(String, String) |
Ersetzt in dieser Instanz alle Vorkommen einer angegebenen Zeichenfolge durch eine andere angegebene Zeichenfolge. |
Replace(Char, Char, Int32, Int32) |
Ersetzt alle Vorkommen eines angegebenen Zeichens in einer Teilzeichenfolge dieser Instanz durch ein anderes angegebenes Zeichen. |
Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Int32, Int32) | |
Replace(String, String, Int32, Int32) |
Ersetzt alle Vorkommen einer angegebenen Zeichenfolge in einer Teilzeichenfolge dieser Instanz durch eine andere angegebene Zeichenfolge. |
Beispiele
Das folgende Beispiel veranschaulicht die Replace Methode.
using namespace System;
using namespace System::Text;
void Show( StringBuilder^ sbs )
{
String^ rule1 = "0----+----1----+----2----+----3----+----4---";
String^ rule2 = "01234567890123456789012345678901234567890123";
Console::WriteLine( rule1 );
Console::WriteLine( rule2 );
Console::WriteLine( "{0}", sbs );
Console::WriteLine();
}
int main()
{
// 0----+----1----+----2----+----3----+----4---
// 01234567890123456789012345678901234567890123
String^ str = "The quick br!wn d#g jumps #ver the lazy cat.";
StringBuilder^ sb = gcnew StringBuilder( str );
Console::WriteLine();
Console::WriteLine( "StringBuilder.Replace method" );
Console::WriteLine();
Console::WriteLine( "Original value:" );
Show( sb );
sb->Replace( '#', '!', 15, 29 ); // Some '#' -> '!'
Show( sb );
sb->Replace( '!', 'o' ); // All '!' -> 'o'
Show( sb );
sb->Replace( "cat", "dog" ); // All "cat" -> "dog"
Show( sb );
sb->Replace( "dog", "fox", 15, 20 ); // Some "dog" -> "fox"
Console::WriteLine( "Final value:" );
Show( sb );
}
/*
This example produces the following results:
StringBuilder.Replace method
Original value:
0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick br!wn d#g jumps #ver the lazy cat.
0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick br!wn d!g jumps !ver the lazy cat.
0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick brown dog jumps over the lazy cat.
0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick brown dog jumps over the lazy dog.
Final value:
0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick brown fox jumps over the lazy dog.
*/
using System;
using System.Text;
class Sample
{
public static void Main()
{
// 0----+----1----+----2----+----3----+----4---
// 01234567890123456789012345678901234567890123
string str = "The quick br!wn d#g jumps #ver the lazy cat.";
StringBuilder sb = new StringBuilder(str);
Console.WriteLine();
Console.WriteLine("StringBuilder.Replace method");
Console.WriteLine();
Console.WriteLine("Original value:");
Show(sb);
sb.Replace('#', '!', 15, 29); // Some '#' -> '!'
Show(sb);
sb.Replace('!', 'o'); // All '!' -> 'o'
Show(sb);
sb.Replace("cat", "dog"); // All "cat" -> "dog"
Show(sb);
sb.Replace("dog", "fox", 15, 20); // Some "dog" -> "fox"
Console.WriteLine("Final value:");
Show(sb);
}
public static void Show(StringBuilder sbs)
{
string rule1 = "0----+----1----+----2----+----3----+----4---";
string rule2 = "01234567890123456789012345678901234567890123";
Console.WriteLine(rule1);
Console.WriteLine(rule2);
Console.WriteLine("{0}", sbs.ToString());
Console.WriteLine();
}
}
/*
This example produces the following results:
StringBuilder.Replace method
Original value:
0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick br!wn d#g jumps #ver the lazy cat.
0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick br!wn d!g jumps !ver the lazy cat.
0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick brown dog jumps over the lazy cat.
0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick brown dog jumps over the lazy dog.
Final value:
0----+----1----+----2----+----3----+----4---
01234567890123456789012345678901234567890123
The quick brown fox jumps over the lazy dog.
*/
open System.Text
let show (sbs: StringBuilder) =
let rule1 = "0----+----1----+----2----+----3----+----4---"
let rule2 = "01234567890123456789012345678901234567890123"
printfn $"{rule1}\n{rule2}\n{sbs}\n"
// 0----+----1----+----2----+----3----+----4---
// 01234567890123456789012345678901234567890123
let str = "The quick br!wn d#g jumps #ver the lazy cat."
let sb = StringBuilder str
printfn "StringBuilder.Replace method\n"
printfn "Original value:"
show sb
sb.Replace('#', '!', 15, 29) |> ignore // Some '#' -> '!'
show sb
sb.Replace('!', 'o') |> ignore // All '!' -> 'o'
show sb
sb.Replace("cat", "dog") |> ignore // All "cat" -> "dog"
show sb
sb.Replace("dog", "fox", 15, 20) |> ignore // Some "dog" -> "fox"
printfn "Final value:"
show sb
// This example produces the following results:
// StringBuilder.Replace method
//
// Original value:
// 0----+----1----+----2----+----3----+----4---
// 01234567890123456789012345678901234567890123
// The quick br!wn d#g jumps #ver the lazy cat.
//
// 0----+----1----+----2----+----3----+----4---
// 01234567890123456789012345678901234567890123
// The quick br!wn d!g jumps !ver the lazy cat.
//
// 0----+----1----+----2----+----3----+----4---
// 01234567890123456789012345678901234567890123
// The quick brown dog jumps over the lazy cat.
//
// 0----+----1----+----2----+----3----+----4---
// 01234567890123456789012345678901234567890123
// The quick brown dog jumps over the lazy dog.
//
// Final value:
// 0----+----1----+----2----+----3----+----4---
// 01234567890123456789012345678901234567890123
// The quick brown fox jumps over the lazy dog.
Imports System.Text
Class Sample
Public Shared Sub Main()
' 0----+----1----+----2----+----3----+----4---
' 01234567890123456789012345678901234567890123
Dim str As String = "The quick br!wn d#g jumps #ver the lazy cat."
Dim sb As New StringBuilder(str)
Console.WriteLine()
Console.WriteLine("StringBuilder.Replace method")
Console.WriteLine()
Console.WriteLine("Original value:")
Show(sb)
sb.Replace("#"c, "!"c, 15, 29) ' Some '#' -> '!'
Show(sb)
sb.Replace("!"c, "o"c) ' All '!' -> 'o'
Show(sb)
sb.Replace("cat", "dog") ' All "cat" -> "dog"
Show(sb)
sb.Replace("dog", "fox", 15, 20) ' Some "dog" -> "fox"
Console.WriteLine("Final value:")
Show(sb)
End Sub
Public Shared Sub Show(sbs As StringBuilder)
Dim rule1 As String = "0----+----1----+----2----+----3----+----4---"
Dim rule2 As String = "01234567890123456789012345678901234567890123"
Console.WriteLine(rule1)
Console.WriteLine(rule2)
Console.WriteLine("{0}", sbs.ToString())
Console.WriteLine()
End Sub
End Class
'
'This example produces the following results:
'
'StringBuilder.Replace method
'
'Original value:
'0----+----1----+----2----+----3----+----4---
'01234567890123456789012345678901234567890123
'The quick br!wn d#g jumps #ver the lazy cat.
'
'0----+----1----+----2----+----3----+----4---
'01234567890123456789012345678901234567890123
'The quick br!wn d!g jumps !ver the lazy cat.
'
'0----+----1----+----2----+----3----+----4---
'01234567890123456789012345678901234567890123
'The quick brown dog jumps over the lazy cat.
'
'0----+----1----+----2----+----3----+----4---
'01234567890123456789012345678901234567890123
'The quick brown dog jumps over the lazy dog.
'
'Final value:
'0----+----1----+----2----+----3----+----4---
'01234567890123456789012345678901234567890123
'The quick brown fox jumps over the lazy dog.
'
Replace(Char, Char)
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
Ersetzt in dieser Instanz alle Vorkommen eines angegebenen Zeichens durch ein anderes angegebenes Zeichen.
public:
System::Text::StringBuilder ^ Replace(char oldChar, char newChar);
public System.Text.StringBuilder Replace (char oldChar, char newChar);
member this.Replace : char * char -> System.Text.StringBuilder
Public Function Replace (oldChar As Char, newChar As Char) As StringBuilder
Parameter
- oldChar
- Char
Das zu ersetzende Zeichen.
- newChar
- Char
Das Zeichen, das oldChar
ersetzt.
Gibt zurück
Ein Verweis auf diese Instanz, bei der oldChar
durch newChar
ersetzt wurde.
Hinweise
Diese Methode führt einen Ordnungsvergleich zwischen Groß- und Kleinschreibung durch, um Vorkommen von oldChar
in der aktuellen instance zu identifizieren. Die Größe des aktuellen StringBuilder instance bleibt nach dem Austausch unverändert.
Gilt für:
Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>)
- Quelle:
- StringBuilder.cs
public:
System::Text::StringBuilder ^ Replace(ReadOnlySpan<char> oldValue, ReadOnlySpan<char> newValue);
public System.Text.StringBuilder Replace (ReadOnlySpan<char> oldValue, ReadOnlySpan<char> newValue);
member this.Replace : ReadOnlySpan<char> * ReadOnlySpan<char> -> System.Text.StringBuilder
Public Function Replace (oldValue As ReadOnlySpan(Of Char), newValue As ReadOnlySpan(Of Char)) As StringBuilder
Parameter
- oldValue
- ReadOnlySpan<Char>
- newValue
- ReadOnlySpan<Char>
Gibt zurück
Gilt für:
Replace(String, String)
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
Ersetzt in dieser Instanz alle Vorkommen einer angegebenen Zeichenfolge durch eine andere angegebene Zeichenfolge.
public:
System::Text::StringBuilder ^ Replace(System::String ^ oldValue, System::String ^ newValue);
public System.Text.StringBuilder Replace (string oldValue, string newValue);
public System.Text.StringBuilder Replace (string oldValue, string? newValue);
member this.Replace : string * string -> System.Text.StringBuilder
Public Function Replace (oldValue As String, newValue As String) As StringBuilder
Parameter
- oldValue
- String
Die zu ersetzende Zeichenfolge.
- newValue
- String
Die Zeichenfolge, die oldValue
ersetzt, oder null
.
Gibt zurück
Ein Verweis auf diese Instanz, bei der alle Vorkommen von oldValue
durch newValue
ersetzt wurden.
Ausnahmen
oldValue
ist null
.
Die Länge von oldValue
ist 0 (null).
Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.
Hinweise
Diese Methode führt einen Ordnungsvergleich zwischen Groß- und Kleinschreibung durch, um Vorkommen von oldValue
in der aktuellen instance zu identifizieren. Wenn newValue
oder String.Emptyistnull
, werden alle Vorkommen von oldValue
entfernt.
Weitere Informationen
Gilt für:
Replace(Char, Char, Int32, Int32)
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
Ersetzt alle Vorkommen eines angegebenen Zeichens in einer Teilzeichenfolge dieser Instanz durch ein anderes angegebenes Zeichen.
public:
System::Text::StringBuilder ^ Replace(char oldChar, char newChar, int startIndex, int count);
public System.Text.StringBuilder Replace (char oldChar, char newChar, int startIndex, int count);
member this.Replace : char * char * int * int -> System.Text.StringBuilder
Public Function Replace (oldChar As Char, newChar As Char, startIndex As Integer, count As Integer) As StringBuilder
Parameter
- oldChar
- Char
Das zu ersetzende Zeichen.
- newChar
- Char
Das Zeichen, das oldChar
ersetzt.
- startIndex
- Int32
Die Position in dieser Instanz, an der die Teilzeichenfolge beginnt.
- count
- Int32
Die Länge der Teilzeichenfolge.
Gibt zurück
Ein Verweis auf diese Instanz, bei der oldChar
im Bereich von startIndex
bis startIndex
+ count
-1 durch newChar
ersetzt wurde.
Ausnahmen
startIndex
+ count
ist größer als die Länge des Werts dieser Instanz.
- oder -
startIndex
oder count
ist kleiner als 0.
Hinweise
Diese Methode führt einen Ordnungsvergleich zwischen Groß- und Kleinschreibung durch, um Vorkommen von oldChar
in der aktuellen instance zu identifizieren. Die Größe des aktuellen StringBuilder Objekts bleibt nach dem Ersetzen unverändert.
Gilt für:
Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Int32, Int32)
- Quelle:
- StringBuilder.cs
public:
System::Text::StringBuilder ^ Replace(ReadOnlySpan<char> oldValue, ReadOnlySpan<char> newValue, int startIndex, int count);
public System.Text.StringBuilder Replace (ReadOnlySpan<char> oldValue, ReadOnlySpan<char> newValue, int startIndex, int count);
member this.Replace : ReadOnlySpan<char> * ReadOnlySpan<char> * int * int -> System.Text.StringBuilder
Public Function Replace (oldValue As ReadOnlySpan(Of Char), newValue As ReadOnlySpan(Of Char), startIndex As Integer, count As Integer) As StringBuilder
Parameter
- oldValue
- ReadOnlySpan<Char>
- newValue
- ReadOnlySpan<Char>
- startIndex
- Int32
- count
- Int32
Gibt zurück
Gilt für:
Replace(String, String, Int32, Int32)
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
- Quelle:
- StringBuilder.cs
Ersetzt alle Vorkommen einer angegebenen Zeichenfolge in einer Teilzeichenfolge dieser Instanz durch eine andere angegebene Zeichenfolge.
public:
System::Text::StringBuilder ^ Replace(System::String ^ oldValue, System::String ^ newValue, int startIndex, int count);
public System.Text.StringBuilder Replace (string oldValue, string newValue, int startIndex, int count);
public System.Text.StringBuilder Replace (string oldValue, string? newValue, int startIndex, int count);
member this.Replace : string * string * int * int -> System.Text.StringBuilder
Public Function Replace (oldValue As String, newValue As String, startIndex As Integer, count As Integer) As StringBuilder
Parameter
- oldValue
- String
Die zu ersetzende Zeichenfolge.
- newValue
- String
Die Zeichenfolge, die oldValue
ersetzt, oder null
.
- startIndex
- Int32
Die Position in dieser Instanz, an der die Teilzeichenfolge beginnt.
- count
- Int32
Die Länge der Teilzeichenfolge.
Gibt zurück
Ein Verweis auf diese Instanz, bei der alle Instanzen von oldValue
im Bereich von startIndex
bis startIndex
+ count
- 1 durch newValue
ersetzt wurden.
Ausnahmen
oldValue
ist null
.
Die Länge von oldValue
ist 0 (null).
startIndex
oder count
ist kleiner als 0.
- oder -
startIndex
plus count
gibt eine Zeichenposition außerhalb dieser Instanz an.
- oder -
Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.
Hinweise
Diese Methode führt einen Ordnungsvergleich zwischen Groß- und Kleinschreibung durch, um vorkommen von oldValue
in der angegebenen Teilzeichenfolge zu identifizieren. Wenn newValue
oder String.Emptyistnull
, werden alle Vorkommen von oldValue
entfernt.
Weitere Informationen
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für