StringBuilder.Replace Metod

Definition

Namnområde:: System.Text

Sammansättningar:: mscorlib.dll, System.Runtime.dll

Sammansättningar:: netstandard.dll, System.Runtime.dll

Sammansättning:: System.Runtime.dll

Sammansättning:: mscorlib.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Ersätter alla förekomster av ett angivet tecken eller en sträng i den här instansen med ett annat angivet tecken eller en annan sträng.

Överlagringar

Name	Description
Replace(Char, Char)	Ersätter alla förekomster av ett angivet tecken i den här instansen med ett annat angivet tecken.
Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	Ersätter alla instanser av ett skrivskyddat teckenintervall med en annan i den här versionen.
Replace(String, String)	Ersätter alla förekomster av en angiven sträng i den här instansen med en annan angiven sträng.
Replace(Rune, Rune)
Replace(Char, Char, Int32, Int32)	Ersätter, inom en delsträng av den här instansen, alla förekomster av ett angivet tecken med ett annat angivet tecken.
Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Int32, Int32)	Ersätter alla instanser av ett skrivskyddat teckenintervall med en annan i en del av den här versionen.
Replace(String, String, Int32, Int32)	Ersätter, inom en delsträng av den här instansen, alla förekomster av en angiven sträng med en annan angiven sträng.
Replace(Rune, Rune, Int32, Int32)

Exempel

I följande exempel visas Replace metoden.

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)

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Ersätter alla förekomster av ett angivet tecken i den här instansen med ett annat angivet tecken.

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

Parametrar

oldChar: Char

Tecknet som ska ersättas.

newChar: Char

Tecknet som ersätter oldChar.

Returer

StringBuilder

En referens till den här instansen med oldChar ersatt av newChar.

Kommentarer

Den här metoden utför en ordningssam, skiftlägeskänslig jämförelse för att identifiera förekomster av oldChar i den aktuella instansen. Storleken på den aktuella StringBuilder instansen är oförändrad efter ersättningen.

Gäller för

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

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Ersätter alla instanser av ett skrivskyddat teckenintervall med en annan i den här versionen.

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

Parametrar

oldValue: ReadOnlySpan<Char>

Det skrivskyddade teckenintervallet som ska ersättas.

newValue: ReadOnlySpan<Char>

Det skrivskyddade teckenintervallet som ska ersättas oldValue med.

Returer

StringBuilder

En referens till den här instansen med oldValue ersatt av newValue.

Kommentarer

Om newValue är tom tas instanser av oldValue bort från den här byggaren.

Gäller för

Replace(String, String)

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Ersätter alla förekomster av en angiven sträng i den här instansen med en annan angiven sträng.

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

Parametrar

oldValue: String

Strängen som ska ersättas.

newValue: String

Strängen som ersätter oldValue, eller null.

Returer

StringBuilder

En referens till den här instansen med alla instanser av oldValue ersatta av newValue.

Undantag

ArgumentNullException

oldValue är null.

ArgumentException

Längden oldValue på är noll.

ArgumentOutOfRangeException

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Den här metoden utför en ordningssam, skiftlägeskänslig jämförelse för att identifiera förekomster av oldValue i den aktuella instansen. Om newValue är null eller String.Emptytas alla förekomster av oldValue bort.

Se även

Remove(Int32, Int32)

Gäller för

Replace(Rune, Rune)

Källa:: StringBuilder.cs

public:
 System::Text::StringBuilder ^ Replace(System::Text::Rune oldRune, System::Text::Rune newRune);

public System.Text.StringBuilder Replace(System.Text.Rune oldRune, System.Text.Rune newRune);

member this.Replace : System.Text.Rune * System.Text.Rune -> System.Text.StringBuilder

Public Function Replace (oldRune As Rune, newRune As Rune) As StringBuilder

Parametrar

oldRune: Rune

newRune: Rune

Returer

StringBuilder

Gäller för

Replace(Char, Char, Int32, Int32)

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Ersätter, inom en delsträng av den här instansen, alla förekomster av ett angivet tecken med ett annat angivet tecken.

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

Parametrar

oldChar: Char

Tecknet som ska ersättas.

newChar: Char

Tecknet som ersätter oldChar.

startIndex: Int32

Positionen i den här instansen där delsträngen börjar.

count: Int32

Längden på delsträngen.

Returer

StringBuilder

En referens till den här instansen som oldChar ersätts av newChar i intervallet från startIndex till startIndex + count -1.

Undantag

ArgumentOutOfRangeException

startIndex + count är större än längden på värdet för den här instansen.

-eller-

startIndex eller count är mindre än noll.

Kommentarer

Den här metoden utför en ordningssam, skiftlägeskänslig jämförelse för att identifiera förekomster av oldChar i den aktuella instansen. Storleken på det aktuella StringBuilder objektet ändras inte efter ersättningen.

Gäller för

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

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Ersätter alla instanser av ett skrivskyddat teckenintervall med en annan i en del av den här versionen.

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

Parametrar

oldValue: ReadOnlySpan<Char>

Det skrivskyddade teckenintervallet som ska ersättas.

newValue: ReadOnlySpan<Char>

Det skrivskyddade teckenintervallet som ska ersättas oldValue med.

startIndex: Int32

Indexet som ska startas i den här versionen.

count: Int32

Antalet tecken som ska läsas i den här byggaren.

Returer

StringBuilder

En referens till den här instansen med oldValue ersatt av newValue.

Kommentarer

Om newValue är tom tas instanser av oldValue bort från den här byggaren.

Gäller för

Replace(String, String, Int32, Int32)

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Ersätter, inom en delsträng av den här instansen, alla förekomster av en angiven sträng med en annan angiven sträng.

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

Parametrar

oldValue: String

Strängen som ska ersättas.

newValue: String

Strängen som ersätter oldValue, eller null.

startIndex: Int32

Positionen i den här instansen där delsträngen börjar.

count: Int32

Längden på delsträngen.

Returer

StringBuilder

En referens till den här instansen med alla instanser av oldValue ersatta med newValue i intervallet från startIndex till startIndex + count - 1.

Undantag

ArgumentNullException

oldValue är null.

ArgumentException

Längden oldValue på är noll.

ArgumentOutOfRangeException

startIndex eller count är mindre än noll.

-eller-

startIndex plus count anger en teckenposition som inte finns i den här instansen.

-eller-

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Den här metoden utför en ordningssam, skiftlägeskänslig jämförelse för att identifiera förekomster av oldValue i den angivna delsträngen. Om newValue är null eller String.Emptytas alla förekomster av oldValue bort.

Se även

Remove(Int32, Int32)

Gäller för

Replace(Rune, Rune, Int32, Int32)

Källa:: StringBuilder.cs

public:
 System::Text::StringBuilder ^ Replace(System::Text::Rune oldRune, System::Text::Rune newRune, int startIndex, int count);

public System.Text.StringBuilder Replace(System.Text.Rune oldRune, System.Text.Rune newRune, int startIndex, int count);

member this.Replace : System.Text.Rune * System.Text.Rune * int * int -> System.Text.StringBuilder

Public Function Replace (oldRune As Rune, newRune As Rune, startIndex As Integer, count As Integer) As StringBuilder

Parametrar

oldRune: Rune

newRune: Rune

startIndex: Int32

count: Int32

Returer

StringBuilder

Gäller för

Feedback

Var den här sidan till hjälp?