StringBuilder.Replace Methode

Referenz

Definition

Namespace:: System.Text

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

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 oder einer angegebenen Zeichenfolge in dieser Instanz durch ein anderes angegebenes Zeichen oder eine andere Zeichenfolge.

Überlädt

Replace(Char, Char)	Ersetzt alle Vorkommen eines angegebenen Zeichens in dieser Instanz durch ein anderes angegebenes Zeichen.
Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	Ersetzt alle Instanzen eines schreibgeschützten Zeichenbereichs durch einen anderen in diesem Generator.
Replace(String, String)	Ersetzt alle Vorkommen einer angegebenen Zeichenfolge in dieser Instanz durch eine andere angegebene Zeichenfolge.
Replace(Char, Char, Int32, Int32)	Ersetzt innerhalb einer Teilzeichenfolge dieser Instanz alle Vorkommen eines angegebenen Zeichens durch ein anderes angegebenes Zeichen.
Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Int32, Int32)	Ersetzt alle Instanzen eines schreibgeschützten Zeichenbereichs durch einen anderen teil dieses Generators.
Replace(String, String, Int32, Int32)	Ersetzt innerhalb einer Teilzeichenfolge dieser Instanz alle Vorkommen einer angegebenen Zeichenfolge durch eine andere angegebene Zeichenfolge.

Beispiele

Im folgenden Beispiel wird die Replace-Methode veranschaulicht.

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 alle Vorkommen eines angegebenen Zeichens in dieser Instanz 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 oldCharersetzt.

Gibt zurück

StringBuilder

Ein Verweis auf diese Instanz mit oldChar durch newCharersetzt.

Hinweise

Diese Methode führt einen ordinalen Vergleich zwischen Groß- und Kleinschreibung aus, um Vorkommen von oldChar in der aktuellen Instanz zu identifizieren. Die Größe der aktuellen StringBuilder Instanz bleibt nach der Ersetzung unverändert.

Gilt für:

Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

Quelle:: StringBuilder.cs

Ersetzt alle Instanzen eines schreibgeschützten Zeichenbereichs durch einen anderen in diesem Generator.

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>

Die schreibgeschützte Zeichenspanne, die ersetzt werden soll.

newValue: ReadOnlySpan<Char>

Die schreibgeschützte Zeichenspanne, durch die oldValue ersetzt werden soll.

Gibt zurück

StringBuilder

Hinweise

Wenn newValue leer ist, werden Instanzen von oldValue aus diesem Generator entfernt.

Gilt für:

Replace(String, String)

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Ersetzt alle Vorkommen einer angegebenen Zeichenfolge in dieser Instanz 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 oldValueoder nullersetzt.

Gibt zurück

StringBuilder

Ein Verweis auf diese Instanz mit allen Instanzen von oldValue durch newValueersetzt.

Ausnahmen

ArgumentNullException

oldValue ist null.

ArgumentException

Die Länge von oldValue ist Null.

ArgumentOutOfRangeException

Durch das Vergrößern des Werts dieser Instanz würde MaxCapacityüberschritten.

Hinweise

Diese Methode führt einen ordinalen Vergleich zwischen Groß- und Kleinschreibung aus, um Vorkommen von oldValue in der aktuellen Instanz zu identifizieren. Wenn newValuenull oder String.Emptyist, werden alle Vorkommen von oldValue entfernt.

Weitere Informationen

Remove(Int32, Int32)

Gilt für:

Replace(Char, Char, Int32, Int32)

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Ersetzt innerhalb einer Teilzeichenfolge dieser Instanz alle Vorkommen eines angegebenen Zeichens 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 oldCharersetzt.

startIndex: Int32

Die Position in dieser Instanz, an der die Teilzeichenfolge beginnt.

count: Int32

Die Länge der Teilzeichenfolge.

Gibt zurück

StringBuilder

Ein Verweis auf diese Instanz mit oldChar ersetzt durch newChar im Bereich von startIndex bis startIndex + count -1.

Ausnahmen

ArgumentOutOfRangeException

startIndex + count ist größer als die Länge des Werts dieser Instanz.

-oder-

startIndex oder count ist kleiner als Null.

Hinweise

Diese Methode führt einen ordinalen Vergleich zwischen Groß- und Kleinschreibung aus, um Vorkommen von oldChar in der aktuellen Instanz zu identifizieren. Die Größe des aktuellen StringBuilder-Objekts bleibt nach der Ersetzung unverändert.

Gilt für:

Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Int32, Int32)

Quelle:: StringBuilder.cs

Ersetzt alle Instanzen eines schreibgeschützten Zeichenbereichs durch einen anderen teil dieses Generators.

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>

Die schreibgeschützte Zeichenspanne, die ersetzt werden soll.

newValue: ReadOnlySpan<Char>

Die schreibgeschützte Zeichenspanne, durch die oldValue ersetzt werden soll.

startIndex: Int32

Der Index, der in diesem Generator beginnen soll.

count: Int32

Die Anzahl der Zeichen, die in diesem Generator gelesen werden sollen.

Gibt zurück

StringBuilder

Hinweise

Wenn newValue leer ist, werden Instanzen von oldValue aus diesem Generator entfernt.

Gilt für:

Replace(String, String, Int32, Int32)

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

Ersetzt innerhalb einer Teilzeichenfolge dieser Instanz alle Vorkommen einer angegebenen Zeichenfolge 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 oldValueoder nullersetzt.

startIndex: Int32

Die Position in dieser Instanz, an der die Teilzeichenfolge beginnt.

count: Int32

Die Länge der Teilzeichenfolge.

Gibt zurück

StringBuilder

Ein Verweis auf diese Instanz mit allen Instanzen von oldValue ersetzt durch newValue im Bereich von startIndex bis startIndex + count - 1.

Ausnahmen

ArgumentNullException

oldValue ist null.

ArgumentException

Die Länge von oldValue ist Null.

ArgumentOutOfRangeException

startIndex oder count ist kleiner als Null.

-oder-

startIndex plus count gibt eine Zeichenposition an, die nicht in dieser Instanz enthalten ist.

-oder-

Durch das Vergrößern des Werts dieser Instanz würde MaxCapacityüberschritten.

Hinweise

Diese Methode führt einen ordinalen Vergleich zwischen Groß- und Kleinschreibung aus, um Vorkommen von oldValue in der angegebenen Teilzeichenfolge zu identifizieren. Wenn newValuenull oder String.Emptyist, werden alle Vorkommen von oldValue entfernt.

Weitere Informationen

Remove(Int32, Int32)

Gilt für:

Teilen über

StringBuilder.Replace Methode

Definition

Überlädt

Beispiele

Replace(Char, Char)

Parameter

Gibt zurück

Hinweise

Gilt für:

Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

Parameter

Gibt zurück

Hinweise

Gilt für:

Replace(String, String)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

Replace(Char, Char, Int32, Int32)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Gilt für:

Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Int32, Int32)

Parameter

Gibt zurück

Hinweise

Gilt für:

Replace(String, String, Int32, Int32)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen