StringBuilder.Replace Metode

Referensi

Definisi

Ruang nama:: System.Text

Rakitan:: System.Runtime.dll

Rakitan:: mscorlib.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengganti semua kemunculan karakter atau string tertentu dalam instans ini dengan karakter atau string lain yang ditentukan.

Overload

Replace(Char, Char)	Mengganti semua kemunculan karakter tertentu dalam instans ini dengan karakter lain yang ditentukan.
Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	Mengganti semua instans dari satu rentang karakter baca-saja dengan yang lain dalam penyusun ini.
Replace(String, String)	Mengganti semua kemunculan string tertentu dalam instans ini dengan string lain yang ditentukan.
Replace(Char, Char, Int32, Int32)	Menggantikan, dalam substring instans ini, semua kemunculan karakter tertentu dengan karakter lain yang ditentukan.
Replace(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Int32, Int32)	Mengganti semua instans dari satu rentang karakter baca-saja dengan yang lain di bagian dari penyusun ini.
Replace(String, String, Int32, Int32)	Menggantikan, dalam substring instans ini, semua kemunculan string tertentu dengan string lain yang ditentukan.

Contoh

Contoh berikut menunjukkan metode Replace.

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)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Mengganti semua kemunculan karakter tertentu dalam instans ini dengan karakter lain yang ditentukan.

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

Karakter yang akan diganti.

newChar: Char

Karakter yang menggantikan oldChar.

Mengembalikan

StringBuilder

Referensi ke instans ini dengan oldChar digantikan oleh newChar.

Keterangan

Metode ini melakukan perbandingan ordinal yang peka huruf besar/kecil untuk mengidentifikasi kemunculan oldChar dalam instans saat ini. Ukuran instans StringBuilder saat ini tidak berubah setelah penggantian.

Berlaku untuk

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

Sumber:: StringBuilder.cs

Mengganti semua instans dari satu rentang karakter baca-saja dengan yang lain dalam penyusun ini.

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>

Rentang karakter baca-saja untuk diganti.

newValue: ReadOnlySpan<Char>

Rentang karakter baca-saja untuk mengganti oldValue dengan.

Mengembalikan

StringBuilder

Keterangan

Jika newValue kosong, instans oldValue dihapus dari penyusun ini.

Berlaku untuk

Replace(String, String)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Mengganti semua kemunculan string tertentu dalam instans ini dengan string lain yang ditentukan.

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

String yang akan diganti.

newValue: String

String yang menggantikan oldValue, atau null.

Mengembalikan

StringBuilder

Referensi ke instans ini dengan semua instans oldValue digantikan oleh newValue.

Pengecualian

ArgumentNullException

oldValue null.

ArgumentException

Panjang oldValue adalah nol.

ArgumentOutOfRangeException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Metode ini melakukan perbandingan ordinal yang peka huruf besar/kecil untuk mengidentifikasi kemunculan oldValue dalam instans saat ini. Jika newValuenull atau String.Empty, semua kemunculan oldValue dihapus.

Lihat juga

Remove(Int32, Int32)

Berlaku untuk

Replace(Char, Char, Int32, Int32)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menggantikan, dalam substring instans ini, semua kemunculan karakter tertentu dengan karakter lain yang ditentukan.

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

Karakter yang akan diganti.

newChar: Char

Karakter yang menggantikan oldChar.

startIndex: Int32

Posisi dalam instans ini di mana substring dimulai.

count: Int32

Panjang substring.

Mengembalikan

StringBuilder

Referensi ke instans ini dengan oldChar digantikan oleh newChar dalam rentang dari startIndex hingga startIndex + count -1.

Pengecualian

ArgumentOutOfRangeException

startIndex + count lebih besar dari panjang nilai instans ini.

-atau-

startIndex atau count kurang dari nol.

Keterangan

Metode ini melakukan perbandingan ordinal yang peka huruf besar/kecil untuk mengidentifikasi kemunculan oldChar dalam instans saat ini. Ukuran objek StringBuilder saat ini tidak berubah setelah penggantian.

Berlaku untuk

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

Sumber:: StringBuilder.cs

Mengganti semua instans dari satu rentang karakter baca-saja dengan yang lain di bagian dari penyusun ini.

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>

Rentang karakter baca-saja untuk diganti.

newValue: ReadOnlySpan<Char>

Rentang karakter baca-saja untuk mengganti oldValue dengan.

startIndex: Int32

Indeks yang akan dimulai dalam penyusun ini.

count: Int32

Jumlah karakter yang akan dibaca dalam penyusun ini.

Mengembalikan

StringBuilder

Keterangan

Jika newValue kosong, instans oldValue dihapus dari penyusun ini.

Berlaku untuk

Replace(String, String, Int32, Int32)

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Sumber:: StringBuilder.cs

Menggantikan, dalam substring instans ini, semua kemunculan string tertentu dengan string lain yang ditentukan.

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

String yang akan diganti.

newValue: String

String yang menggantikan oldValue, atau null.

startIndex: Int32

Posisi dalam instans ini di mana substring dimulai.

count: Int32

Panjang substring.

Mengembalikan

StringBuilder

Referensi ke instans ini dengan semua instans oldValue digantikan oleh newValue dalam rentang dari startIndex hingga startIndex + count - 1.

Pengecualian

ArgumentNullException

oldValue null.

ArgumentException

Panjang oldValue adalah nol.

ArgumentOutOfRangeException

startIndex atau count kurang dari nol.

-atau-

startIndex plus count menunjukkan posisi karakter yang tidak ada dalam instans ini.

-atau-

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Metode ini melakukan perbandingan ordinal dan peka huruf besar/kecil untuk mengidentifikasi kemunculan oldValue dalam substring yang ditentukan. Jika newValuenull atau String.Empty, semua kemunculan oldValue dihapus.

Lihat juga

Remove(Int32, Int32)

Berlaku untuk

Bagikan melalui

StringBuilder.Replace Metode

Definisi

Overload

Contoh

Replace(Char, Char)

Parameter

Mengembalikan

Keterangan

Berlaku untuk

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

Parameter

Mengembalikan

Keterangan

Berlaku untuk

Replace(String, String)

Parameter

Mengembalikan

Pengecualian

Keterangan

Lihat juga

Berlaku untuk

Replace(Char, Char, Int32, Int32)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

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

Parameter

Mengembalikan

Keterangan

Berlaku untuk

Replace(String, String, Int32, Int32)

Parameter

Mengembalikan

Pengecualian

Keterangan

Lihat juga

Berlaku untuk

Sumber Daya Tambahan: