StringBuilder.Replace Methode

Definitie

Naamruimte:: System.Text

Assembly's:: mscorlib.dll, System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Vervangt alle exemplaren van een opgegeven teken of tekenreeks in dit exemplaar door een ander opgegeven teken of tekenreeks.

Overloads

Name	Description
Replace(Char, Char)	Vervangt alle exemplaren van een opgegeven teken in dit exemplaar door een ander opgegeven teken.
Replace(String, String)	Vervangt alle exemplaren van een opgegeven tekenreeks in dit exemplaar door een andere opgegeven tekenreeks.
Replace(Char, Char, Int32, Int32)	Vervangt, binnen een subtekenreeks van dit exemplaar, alle exemplaren van een opgegeven teken door een ander opgegeven teken.
Replace(String, String, Int32, Int32)	Vervangt, binnen een subtekenreeks van dit exemplaar, alle exemplaren van een opgegeven tekenreeks door een andere opgegeven tekenreeks.

Voorbeelden

In het volgende voorbeeld ziet u de Replace methode.

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)

Vervangt alle exemplaren van een opgegeven teken in dit exemplaar door een ander opgegeven teken.

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

Parameters

oldChar: Char

Het teken dat moet worden vervangen.

newChar: Char

Het teken dat vervangt oldChar.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar door oldChar vervangen door newChar.

Opmerkingen

Met deze methode wordt een ordinale, hoofdlettergevoelige vergelijking uitgevoerd om exemplaren van oldChar het huidige exemplaar te identificeren. De grootte van het huidige StringBuilder exemplaar is ongewijzigd na de vervanging.

Van toepassing op

Replace(String, String)

Vervangt alle exemplaren van een opgegeven tekenreeks in dit exemplaar door een andere opgegeven tekenreeks.

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

Parameters

oldValue: String

De tekenreeks die moet worden vervangen.

newValue: String

De tekenreeks die vervangt oldValue, of null.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar met alle exemplaren van oldValue vervangen door newValue.

Uitzonderingen

ArgumentNullException

oldValue is null.

ArgumentException

De lengte is oldValue nul.

ArgumentOutOfRangeException

Het vergroten van de waarde van dit exemplaar zou groter zijn dan MaxCapacity.

Opmerkingen

Met deze methode wordt een ordinale, hoofdlettergevoelige vergelijking uitgevoerd om exemplaren van oldValue het huidige exemplaar te identificeren. Als newValue dat het geval is null of String.Empty, worden alle exemplaren verwijderd oldValue .

Zie ook

Remove(Int32, Int32)

Van toepassing op

Replace(Char, Char, Int32, Int32)

Vervangt, binnen een subtekenreeks van dit exemplaar, alle exemplaren van een opgegeven teken door een ander opgegeven teken.

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

Parameters

oldChar: Char

Het teken dat moet worden vervangen.

newChar: Char

Het teken dat vervangt oldChar.

startIndex: Int32

De positie in dit exemplaar waar de subtekenreeks begint.

count: Int32

De lengte van de subtekenreeks.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar door vervangen door newChar in het bereik vancount + startIndexstartIndex -1.oldChar

Uitzonderingen

ArgumentOutOfRangeException

startIndex + count is groter dan de lengte van de waarde van dit exemplaar.

– of –

startIndex of count kleiner is dan nul.

Opmerkingen

Van toepassing op

Replace(String, String, Int32, Int32)

Vervangt, binnen een subtekenreeks van dit exemplaar, alle exemplaren van een opgegeven tekenreeks door een andere opgegeven tekenreeks.

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

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

Parameters

oldValue: String

De tekenreeks die moet worden vervangen.

newValue: String

De tekenreeks die vervangt oldValue, of null.

startIndex: Int32

De positie in dit exemplaar waar de subtekenreeks begint.

count: Int32

De lengte van de subtekenreeks.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar met alle exemplaren die oldValue zijn vervangen door newValue in het bereik van startIndex - startIndex + count 1.

Uitzonderingen

ArgumentNullException

oldValue is null.

ArgumentException

De lengte is oldValue nul.

ArgumentOutOfRangeException

startIndex of count kleiner is dan nul.

– of –

startIndex plus count geeft een tekenpositie aan die zich niet binnen dit exemplaar bevindt.

– of –

Het vergroten van de waarde van dit exemplaar zou groter zijn dan MaxCapacity.

Opmerkingen

Met deze methode wordt een ordinale, hoofdlettergevoelige vergelijking uitgevoerd om exemplaren van oldValue de opgegeven subtekenreeks te identificeren. Als newValue dat het geval is null of String.Empty, worden alle exemplaren verwijderd oldValue .

Zie ook

Remove(Int32, Int32)

Van toepassing op

Feedback

Is deze pagina nuttig?