Regex.Replace Metode

Definisi

Dalam string input tertentu, mengganti string yang cocok dengan pola ekspresi reguler dengan string pengganti yang ditentukan.

Overload

Nama Deskripsi
Replace(String, String, String, RegexOptions)

Dalam string input tertentu, mengganti semua string yang cocok dengan ekspresi reguler tertentu dengan string pengganti yang ditentukan. Opsi yang ditentukan mengubah operasi pencocokan.

Replace(String, String, String, RegexOptions, TimeSpan)

Dalam string input tertentu, mengganti semua string yang cocok dengan ekspresi reguler tertentu dengan string pengganti yang ditentukan. Parameter tambahan menentukan opsi yang memodifikasi operasi pencocokan dan interval waktu habis jika tidak ada kecocokan yang ditemukan.

Replace(String, MatchEvaluator, Int32, Int32)

Dalam substring input tertentu, menggantikan jumlah maksimum string tertentu yang cocok dengan pola ekspresi reguler dengan string yang MatchEvaluator dikembalikan oleh delegasi.

Replace(String, String, MatchEvaluator, RegexOptions)

Dalam string input tertentu, mengganti semua string yang cocok dengan ekspresi reguler tertentu dengan string yang MatchEvaluator dikembalikan oleh delegasi. Opsi yang ditentukan mengubah operasi pencocokan.

Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan)

Dalam string input tertentu, mengganti semua substring yang cocok dengan ekspresi reguler tertentu dengan string yang MatchEvaluator dikembalikan oleh delegasi. Parameter tambahan menentukan opsi yang memodifikasi operasi pencocokan dan interval waktu habis jika tidak ada kecocokan yang ditemukan.

Replace(String, String, Int32, Int32)

Dalam substring input tertentu, menggantikan jumlah maksimum string tertentu yang cocok dengan pola ekspresi reguler dengan string pengganti yang ditentukan.

Replace(String, String, String)

Dalam string input tertentu, mengganti semua string yang cocok dengan pola ekspresi reguler tertentu dengan string pengganti yang ditentukan.

Replace(String, String, MatchEvaluator)

Dalam string input tertentu, mengganti semua string yang cocok dengan ekspresi reguler tertentu dengan string yang MatchEvaluator dikembalikan oleh delegasi.

Replace(String, String, Int32)

Dalam string input tertentu, mengganti jumlah maksimum string tertentu yang cocok dengan pola ekspresi reguler dengan string pengganti yang ditentukan.

Replace(String, MatchEvaluator)

Dalam string input tertentu, mengganti semua string yang cocok dengan ekspresi reguler tertentu dengan string yang MatchEvaluator dikembalikan oleh delegasi.

Replace(String, String)

Dalam string input tertentu, mengganti semua string yang cocok dengan pola ekspresi reguler dengan string pengganti yang ditentukan.

Replace(String, MatchEvaluator, Int32)

Dalam string input tertentu, menggantikan jumlah maksimum string tertentu yang cocok dengan pola ekspresi reguler dengan string yang MatchEvaluator dikembalikan oleh delegasi.

Replace(String, String, String, RegexOptions)

Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs

Dalam string input tertentu, mengganti semua string yang cocok dengan ekspresi reguler tertentu dengan string pengganti yang ditentukan. Opsi yang ditentukan mengubah operasi pencocokan.

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::String ^ replacement, System::Text::RegularExpressions::RegexOptions options);
public static string Replace(string input, string pattern, string replacement, System.Text.RegularExpressions.RegexOptions options);
static member Replace : string * string * string * System.Text.RegularExpressions.RegexOptions -> string
Public Shared Function Replace (input As String, pattern As String, replacement As String, options As RegexOptions) As String

Parameter

input
String

String untuk mencari kecocokan.

pattern
String

Pola ekspresi reguler yang cocok.

replacement
String

String pengganti.

options
RegexOptions

Kombinasi bitwise dari nilai enumerasi yang menyediakan opsi untuk pencocokan.

Mengembalikan

String baru yang identik dengan string input, kecuali bahwa string pengganti menggantikan setiap string yang cocok. Jika pattern tidak cocok dalam instans saat ini, metode mengembalikan instans saat ini yang tidak berubah.

Pengecualian

Terjadi kesalahan penguraian ekspresi reguler.

input, pattern, atau replacement adalah null.

options bukan kombinasi RegexOptions nilai bitwise yang valid.

Waktu habis terjadi.

Keterangan

Metode statis Replace(String, String, String, RegexOptions) setara dengan membangun Regex objek dengan pola ekspresi reguler yang ditentukan dan memanggil metode Replace(String, String)instans .

Parameter replacement menentukan string yang menggantikan setiap kecocokan di input. replacement dapat terdiri dari kombinasi teks harfiah dan substitusi. Penggantian adalah satu-satunya elemen bahasa ekspresi reguler yang dikenali dalam pola pengganti.

Karena metode mengembalikan input tidak berubah jika tidak ada kecocokan ReferenceEquals(Object, Object) , Anda dapat menggunakan metode untuk menentukan apakah metode telah membuat penggantian apa pun.

Jika Anda menentukan RightToLeft parameter options , pencarian kecocokan dimulai di akhir string input dan bergerak ke kiri; jika tidak, pencarian dimulai di awal string input dan bergerak ke kanan.

Catatan Bagi Pemanggil

Metode ini kehabisan waktu setelah interval yang sama dengan nilai batas waktu default domain aplikasi di mana ia dipanggil. Jika nilai waktu habis belum ditentukan untuk domain aplikasi, nilai InfiniteMatchTimeout, yang mencegah metode kehabisan waktu, digunakan. Metode statis yang direkomendasikan untuk mengganti kecocokan pola adalah Replace(String, String, String, RegexOptions, TimeSpan), yang memungkinkan Anda mengatur interval waktu habis.

Lihat juga

Berlaku untuk

Replace(String, String, String, RegexOptions, TimeSpan)

Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs

Dalam string input tertentu, mengganti semua string yang cocok dengan ekspresi reguler tertentu dengan string pengganti yang ditentukan. Parameter tambahan menentukan opsi yang memodifikasi operasi pencocokan dan interval waktu habis jika tidak ada kecocokan yang ditemukan.

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::String ^ replacement, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);
public static string Replace(string input, string pattern, string replacement, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);
static member Replace : string * string * string * System.Text.RegularExpressions.RegexOptions * TimeSpan -> string
Public Shared Function Replace (input As String, pattern As String, replacement As String, options As RegexOptions, matchTimeout As TimeSpan) As String

Parameter

input
String

String untuk mencari kecocokan.

pattern
String

Pola ekspresi reguler yang cocok.

replacement
String

String pengganti.

options
RegexOptions

Kombinasi bitwise dari nilai enumerasi yang menyediakan opsi untuk pencocokan.

matchTimeout
TimeSpan

Interval waktu habis, atau InfiniteMatchTimeout untuk menunjukkan bahwa metode tidak boleh kehabisan waktu.

Mengembalikan

String baru yang identik dengan string input, kecuali bahwa string pengganti menggantikan setiap string yang cocok. Jika pattern tidak cocok dalam instans saat ini, metode mengembalikan instans saat ini yang tidak berubah.

Pengecualian

Terjadi kesalahan penguraian ekspresi reguler.

input, pattern, atau replacement adalah null.

options bukan kombinasi RegexOptions nilai bitwise yang valid. -atau- matchTimeout negatif, nol, atau lebih besar dari sekitar 24 hari.

Waktu habis terjadi.

Keterangan

Metode statis Replace(String, String, String, RegexOptions, TimeSpan) setara dengan membangun Regex objek dengan pola ekspresi reguler yang ditentukan dan memanggil metode Replace(String, String)instans .

Parameter replacement menentukan string yang menggantikan setiap kecocokan di input. replacement dapat terdiri dari kombinasi teks harfiah dan substitusi. Penggantian adalah satu-satunya elemen bahasa ekspresi reguler yang dikenali dalam pola pengganti.

Karena metode mengembalikan input tidak berubah jika tidak ada kecocokan ReferenceEquals(Object, Object) , Anda dapat menggunakan metode untuk menentukan apakah metode telah membuat penggantian apa pun.

Jika Anda menentukan RightToLeft parameter options , pencarian kecocokan dimulai di akhir string input dan bergerak ke kiri; jika tidak, pencarian dimulai di awal string input dan bergerak ke kanan.

Parameter matchTimeout menentukan berapa lama metode pencocokan pola harus mencoba menemukan kecocokan sebelum waktu habis. Mengatur interval waktu habis mencegah ekspresi reguler yang mengandalkan backtracking yang berlebihan muncul untuk berhenti merespons saat mereka memproses input yang berisi kecocokan dekat. matchTimeout mengambil alih nilai batas waktu default yang ditentukan untuk domain aplikasi tempat metode dijalankan.

Catatan Bagi Pemanggil

Kami menyarankan agar Anda mengatur matchTimeout parameter ke nilai yang sesuai, seperti dua detik. Jika Anda menonaktifkan batas waktu dengan menentukan InfiniteMatchTimeout, mesin ekspresi reguler menawarkan performa yang sedikit lebih baik. Namun, Anda harus menonaktifkan batas waktu hanya dalam kondisi berikut:

  • Ketika input yang diproses oleh ekspresi reguler berasal dari sumber yang diketahui dan tepercaya atau terdiri dari teks statis. Ini mengecualikan teks yang telah dimasukkan secara dinamis oleh pengguna.

  • Ketika pola ekspresi reguler telah diuji secara menyeluruh untuk memastikan bahwa pola regex secara efisien menangani kecocokan, non-kecocokan, dan mendekati kecocokan.

  • Ketika pola ekspresi reguler tidak berisi elemen bahasa yang diketahui menyebabkan backtracking yang berlebihan saat memproses kecocokan dekat.

Lihat juga

Berlaku untuk

Replace(String, MatchEvaluator, Int32, Int32)

Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs

Dalam substring input tertentu, menggantikan jumlah maksimum string tertentu yang cocok dengan pola ekspresi reguler dengan string yang MatchEvaluator dikembalikan oleh delegasi.

public:
 System::String ^ Replace(System::String ^ input, System::Text::RegularExpressions::MatchEvaluator ^ evaluator, int count, int startat);
public string Replace(string input, System.Text.RegularExpressions.MatchEvaluator evaluator, int count, int startat);
member this.Replace : string * System.Text.RegularExpressions.MatchEvaluator * int * int -> string
Public Function Replace (input As String, evaluator As MatchEvaluator, count As Integer, startat As Integer) As String

Parameter

input
String

String untuk mencari kecocokan.

evaluator
MatchEvaluator

Metode kustom yang memeriksa setiap kecocokan dan mengembalikan string asli yang cocok atau string pengganti.

count
Int32

Jumlah maksimum kali penggantian akan terjadi.

startat
Int32

Posisi karakter dalam string input tempat pencarian dimulai.

Mengembalikan

String baru yang identik dengan string input, kecuali bahwa string pengganti menggantikan setiap string yang cocok. Jika pola ekspresi reguler tidak cocok dalam instans saat ini, metode mengembalikan instans saat ini tidak berubah.

Pengecualian

input atau evaluator adalah null.

startat kurang dari nol atau lebih besar dari inputpanjang .

Waktu habis terjadi.

Keterangan

Untuk detail selengkapnya tentang startat, lihat bagian Keterangan dari Match(String, Int32).

Metode meneruskan objek pertama countMatch ke evaluator delegasi.

Lihat juga

Berlaku untuk

Replace(String, String, MatchEvaluator, RegexOptions)

Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs

Dalam string input tertentu, mengganti semua string yang cocok dengan ekspresi reguler tertentu dengan string yang MatchEvaluator dikembalikan oleh delegasi. Opsi yang ditentukan mengubah operasi pencocokan.

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::MatchEvaluator ^ evaluator, System::Text::RegularExpressions::RegexOptions options);
public static string Replace(string input, string pattern, System.Text.RegularExpressions.MatchEvaluator evaluator, System.Text.RegularExpressions.RegexOptions options);
static member Replace : string * string * System.Text.RegularExpressions.MatchEvaluator * System.Text.RegularExpressions.RegexOptions -> string
Public Shared Function Replace (input As String, pattern As String, evaluator As MatchEvaluator, options As RegexOptions) As String

Parameter

input
String

String untuk mencari kecocokan.

pattern
String

Pola ekspresi reguler yang cocok.

evaluator
MatchEvaluator

Metode kustom yang memeriksa setiap kecocokan dan mengembalikan string asli yang cocok atau string pengganti.

options
RegexOptions

Kombinasi bitwise dari nilai enumerasi yang menyediakan opsi untuk pencocokan.

Mengembalikan

String baru yang identik dengan string input, kecuali bahwa string pengganti menggantikan setiap string yang cocok. Jika pattern tidak cocok dalam instans saat ini, metode mengembalikan instans saat ini yang tidak berubah.

Pengecualian

Terjadi kesalahan penguraian ekspresi reguler.

input, pattern, atau evaluator adalah null.

options bukan kombinasi RegexOptions nilai bitwise yang valid.

Waktu habis terjadi.

Keterangan

Metode ini berguna untuk mengganti kecocokan ekspresi reguler jika salah satu kondisi berikut ini benar: string pengganti tidak dapat dengan mudah ditentukan oleh pola penggantian ekspresi reguler, hasil string pengganti dari pemrosesan string yang cocok, atau string pengganti hasil dari pemrosesan bersyariah.

Metode ini setara dengan memanggil Matches(String, String) metode dan meneruskan setiap Match objek dalam yang dikembalikan MatchCollection ke evaluator delegasi.

Karena metode mengembalikan input tidak berubah jika tidak ada kecocokan ReferenceEquals(Object, Object) , Anda dapat menggunakan metode untuk menentukan apakah metode telah membuat penggantian apa pun.

Jika Anda menentukan RightToLeft parameter options , pencarian kecocokan dimulai di akhir string input dan bergerak ke kiri; jika tidak, pencarian dimulai di awal string input dan bergerak ke kanan.

Lihat juga

Berlaku untuk

Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan)

Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs

Dalam string input tertentu, mengganti semua substring yang cocok dengan ekspresi reguler tertentu dengan string yang MatchEvaluator dikembalikan oleh delegasi. Parameter tambahan menentukan opsi yang memodifikasi operasi pencocokan dan interval waktu habis jika tidak ada kecocokan yang ditemukan.

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::MatchEvaluator ^ evaluator, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);
public static string Replace(string input, string pattern, System.Text.RegularExpressions.MatchEvaluator evaluator, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);
static member Replace : string * string * System.Text.RegularExpressions.MatchEvaluator * System.Text.RegularExpressions.RegexOptions * TimeSpan -> string
Public Shared Function Replace (input As String, pattern As String, evaluator As MatchEvaluator, options As RegexOptions, matchTimeout As TimeSpan) As String

Parameter

input
String

String untuk mencari kecocokan.

pattern
String

Pola ekspresi reguler yang cocok.

evaluator
MatchEvaluator

Metode kustom yang memeriksa setiap kecocokan dan mengembalikan string asli yang cocok atau string pengganti.

options
RegexOptions

Kombinasi bitwise dari nilai enumerasi yang menyediakan opsi untuk pencocokan.

matchTimeout
TimeSpan

Interval waktu habis, atau InfiniteMatchTimeout untuk menunjukkan bahwa metode tidak boleh kehabisan waktu.

Mengembalikan

String baru yang identik dengan string input, kecuali bahwa string pengganti menggantikan setiap string yang cocok. Jika pattern tidak cocok dalam instans saat ini, metode mengembalikan instans saat ini yang tidak berubah.

Pengecualian

Terjadi kesalahan penguraian ekspresi reguler.

input, pattern, atau evaluator adalah null.

options bukan kombinasi RegexOptions nilai bitwise yang valid. -atau- matchTimeout negatif, nol, atau lebih besar dari sekitar 24 hari.

Waktu habis terjadi.

Keterangan

Metode ini berguna untuk mengganti kecocokan ekspresi reguler jika salah satu kondisi berikut ini benar: string pengganti tidak dapat dengan mudah ditentukan oleh pola penggantian ekspresi reguler, hasil string pengganti dari pemrosesan string yang cocok, atau string pengganti hasil dari pemrosesan bersyariah.

Metode ini setara dengan memanggil Matches(String, String) metode dan meneruskan setiap Match objek dalam yang dikembalikan MatchCollection ke evaluator delegasi.

Karena metode mengembalikan input tidak berubah jika tidak ada kecocokan ReferenceEquals(Object, Object) , Anda dapat menggunakan metode untuk menentukan apakah metode telah membuat penggantian apa pun.

Jika Anda menentukan RightToLeft parameter options , pencarian kecocokan dimulai di akhir string input dan bergerak ke kiri; jika tidak, pencarian dimulai di awal string input dan bergerak ke kanan.

Parameter matchTimeout menentukan berapa lama metode pencocokan pola harus mencoba menemukan kecocokan sebelum waktu habis. matchTimeout mengambil alih nilai batas waktu default yang ditentukan untuk domain aplikasi tempat metode dijalankan.

Catatan Bagi Pemanggil

Kami menyarankan agar Anda mengatur matchTimeout parameter ke nilai yang sesuai, seperti dua detik. Jika Anda menonaktifkan batas waktu dengan menentukan InfiniteMatchTimeout, mesin ekspresi reguler menawarkan performa yang sedikit lebih baik. Namun, Anda harus menonaktifkan batas waktu hanya dalam kondisi berikut:

  • Ketika input yang diproses oleh ekspresi reguler berasal dari sumber yang diketahui dan tepercaya atau terdiri dari teks statis. Ini mengecualikan teks yang telah dimasukkan secara dinamis oleh pengguna.

  • Ketika pola ekspresi reguler telah diuji secara menyeluruh untuk memastikan bahwa pola regex secara efisien menangani kecocokan, non-kecocokan, dan mendekati kecocokan.

  • Ketika pola ekspresi reguler tidak berisi elemen bahasa yang diketahui menyebabkan backtracking yang berlebihan saat memproses kecocokan dekat.

Lihat juga

Berlaku untuk

Replace(String, String, Int32, Int32)

Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs

Dalam substring input tertentu, menggantikan jumlah maksimum string tertentu yang cocok dengan pola ekspresi reguler dengan string pengganti yang ditentukan.

public:
 System::String ^ Replace(System::String ^ input, System::String ^ replacement, int count, int startat);
public string Replace(string input, string replacement, int count, int startat);
member this.Replace : string * string * int * int -> string
Public Function Replace (input As String, replacement As String, count As Integer, startat As Integer) As String

Parameter

input
String

String untuk mencari kecocokan.

replacement
String

String pengganti.

count
Int32

Berapa kali penggantian dapat terjadi.

startat
Int32

Posisi karakter dalam string input tempat pencarian dimulai.

Mengembalikan

String baru yang identik dengan string input, kecuali bahwa string pengganti menggantikan setiap string yang cocok. Jika pola ekspresi reguler tidak cocok dalam instans saat ini, metode mengembalikan instans saat ini tidak berubah.

Pengecualian

input atau replacement adalah null.

startat kurang dari nol atau lebih besar dari inputpanjang .

Waktu habis terjadi.

Keterangan

Untuk detail selengkapnya tentang startat, lihat bagian Keterangan dari Match(String, Int32).

Parameter replacement menentukan string yang menggantikan setiap kecocokan dan mendukung substitusi.

Jika count negatif, penggantian berlanjut ke akhir string.

Lihat juga

Berlaku untuk

Replace(String, String, String)

Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs

Dalam string input tertentu, mengganti semua string yang cocok dengan pola ekspresi reguler tertentu dengan string pengganti yang ditentukan.

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::String ^ replacement);
public static string Replace(string input, string pattern, string replacement);
static member Replace : string * string * string -> string
Public Shared Function Replace (input As String, pattern As String, replacement As String) As String

Parameter

input
String

String untuk mencari kecocokan.

pattern
String

Pola ekspresi reguler yang cocok.

replacement
String

String pengganti.

Mengembalikan

String baru yang identik dengan string input, kecuali bahwa string pengganti menggantikan setiap string yang cocok. Jika pattern tidak cocok dalam instans saat ini, metode mengembalikan instans saat ini yang tidak berubah.

Pengecualian

Terjadi kesalahan penguraian ekspresi reguler.

input, pattern, atau replacement adalah null.

Waktu habis terjadi.

Keterangan

Metode statis Replace(String, String, String) setara dengan membangun Regex objek dengan pola ekspresi reguler yang ditentukan dan memanggil metode Replace(String, String)instans .

Parameter replacement menentukan string yang menggantikan setiap kecocokan di input. replacement dapat terdiri dari kombinasi teks harfiah dan substitusi. Penggantian adalah satu-satunya elemen bahasa ekspresi reguler yang dikenali dalam pola pengganti.

Karena metode mengembalikan input tidak berubah jika tidak ada kecocokan ReferenceEquals(Object, Object) , Anda dapat menggunakan metode untuk menentukan apakah metode telah membuat penggantian apa pun.

Catatan Bagi Pemanggil

Metode ini kehabisan waktu setelah interval yang sama dengan nilai batas waktu default domain aplikasi di mana ia dipanggil. Jika nilai waktu habis belum ditentukan untuk domain aplikasi, nilai InfiniteMatchTimeout, yang mencegah metode kehabisan waktu, digunakan. Metode statis yang direkomendasikan untuk mengganti kecocokan pola adalah Replace(String, String, String, RegexOptions, TimeSpan), yang memungkinkan Anda mengatur interval waktu habis.

Lihat juga

Berlaku untuk

Replace(String, String, MatchEvaluator)

Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs

Dalam string input tertentu, mengganti semua string yang cocok dengan ekspresi reguler tertentu dengan string yang MatchEvaluator dikembalikan oleh delegasi.

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::MatchEvaluator ^ evaluator);
public static string Replace(string input, string pattern, System.Text.RegularExpressions.MatchEvaluator evaluator);
static member Replace : string * string * System.Text.RegularExpressions.MatchEvaluator -> string
Public Shared Function Replace (input As String, pattern As String, evaluator As MatchEvaluator) As String

Parameter

input
String

String untuk mencari kecocokan.

pattern
String

Pola ekspresi reguler yang cocok.

evaluator
MatchEvaluator

Metode kustom yang memeriksa setiap kecocokan dan mengembalikan string asli yang cocok atau string pengganti.

Mengembalikan

String baru yang identik dengan string input, kecuali bahwa string pengganti menggantikan setiap string yang cocok. Jika pattern tidak cocok dalam instans saat ini, metode mengembalikan instans saat ini yang tidak berubah.

Pengecualian

Terjadi kesalahan penguraian ekspresi reguler.

input, pattern, atau evaluator adalah null.

Waktu habis terjadi.

Keterangan

Metode ini berguna untuk mengganti kecocokan ekspresi reguler jika salah satu kondisi berikut ini benar: string pengganti tidak dapat dengan mudah ditentukan oleh pola penggantian ekspresi reguler, hasil string pengganti dari pemrosesan string yang cocok, atau string pengganti hasil dari pemrosesan bersyariah.

Metode ini setara dengan memanggil Matches(String, String) metode dan meneruskan setiap Match objek dalam yang dikembalikan MatchCollection ke evaluator delegasi.

Karena metode mengembalikan input tidak berubah jika tidak ada kecocokan ReferenceEquals(Object, Object) , Anda dapat menggunakan metode untuk menentukan apakah metode telah membuat penggantian apa pun.

Catatan Bagi Pemanggil

Metode ini kehabisan waktu setelah interval yang sama dengan nilai batas waktu default domain aplikasi di mana ia dipanggil. Jika nilai waktu habis belum ditentukan untuk domain aplikasi, nilai InfiniteMatchTimeout, yang mencegah metode kehabisan waktu, digunakan. Metode statis yang direkomendasikan untuk mengevaluasi dan mengganti kecocokan pola adalah Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan), yang memungkinkan Anda mengatur interval waktu habis.

Lihat juga

Berlaku untuk

Replace(String, String, Int32)

Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs

Dalam string input tertentu, mengganti jumlah maksimum string tertentu yang cocok dengan pola ekspresi reguler dengan string pengganti yang ditentukan.

public:
 System::String ^ Replace(System::String ^ input, System::String ^ replacement, int count);
public string Replace(string input, string replacement, int count);
member this.Replace : string * string * int -> string
Public Function Replace (input As String, replacement As String, count As Integer) As String

Parameter

input
String

String untuk mencari kecocokan.

replacement
String

String pengganti.

count
Int32

Berapa kali penggantian dapat terjadi.

Mengembalikan

String baru yang identik dengan string input, kecuali bahwa string pengganti menggantikan setiap string yang cocok. Jika pola ekspresi reguler tidak cocok dalam instans saat ini, metode mengembalikan instans saat ini tidak berubah.

Pengecualian

input atau replacement adalah null.

Waktu habis terjadi.

Keterangan

Pencarian dimulai pada awal input string. Parameter replacement menentukan string yang menggantikan setiap kecocokan dan mendukung substitusi.

Jika count negatif, penggantian berlanjut ke akhir string.

Karena metode mengembalikan input tidak berubah jika tidak ada kecocokan ReferenceEquals(Object, Object) , Anda dapat menggunakan metode untuk menentukan apakah metode telah membuat penggantian apa pun.

Lihat juga

Berlaku untuk

Replace(String, MatchEvaluator)

Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs

Dalam string input tertentu, mengganti semua string yang cocok dengan ekspresi reguler tertentu dengan string yang MatchEvaluator dikembalikan oleh delegasi.

public:
 System::String ^ Replace(System::String ^ input, System::Text::RegularExpressions::MatchEvaluator ^ evaluator);
public string Replace(string input, System.Text.RegularExpressions.MatchEvaluator evaluator);
member this.Replace : string * System.Text.RegularExpressions.MatchEvaluator -> string
Public Function Replace (input As String, evaluator As MatchEvaluator) As String

Parameter

input
String

String untuk mencari kecocokan.

evaluator
MatchEvaluator

Metode kustom yang memeriksa setiap kecocokan dan mengembalikan string asli yang cocok atau string pengganti.

Mengembalikan

String baru yang identik dengan string input, kecuali bahwa string pengganti menggantikan setiap string yang cocok. Jika pola ekspresi reguler tidak cocok dalam instans saat ini, metode mengembalikan instans saat ini tidak berubah.

Pengecualian

input atau evaluator adalah null.

Waktu habis terjadi.

Keterangan

Metode ini berguna untuk mengganti kecocokan ekspresi reguler jika salah satu kondisi berikut ini benar: string pengganti tidak dapat dengan mudah ditentukan oleh pola penggantian ekspresi reguler, hasil string pengganti dari pemrosesan string yang cocok, atau string pengganti hasil dari pemrosesan bersyariah.

Metode ini setara dengan memanggil Matches(String) metode dan meneruskan setiap Match objek dalam yang dikembalikan MatchCollection ke evaluator delegasi.

Karena metode mengembalikan input tidak berubah jika tidak ada kecocokan ReferenceEquals(Object, Object) , Anda dapat menggunakan metode untuk menentukan apakah metode telah membuat penggantian apa pun.

Lihat juga

Berlaku untuk

Replace(String, String)

Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs

Dalam string input tertentu, mengganti semua string yang cocok dengan pola ekspresi reguler dengan string pengganti yang ditentukan.

public:
 System::String ^ Replace(System::String ^ input, System::String ^ replacement);
public string Replace(string input, string replacement);
member this.Replace : string * string -> string
Public Function Replace (input As String, replacement As String) As String

Parameter

input
String

String untuk mencari kecocokan.

replacement
String

String pengganti.

Mengembalikan

String baru yang identik dengan string input, kecuali bahwa string pengganti menggantikan setiap string yang cocok. Jika pola ekspresi reguler tidak cocok dalam instans saat ini, metode mengembalikan instans saat ini tidak berubah.

Pengecualian

input atau replacement adalah null.

Waktu habis terjadi.

Keterangan

Pencarian pola dimulai di awal input string.

Parameter replacement menentukan string yang menggantikan setiap kecocokan. replacement dapat terdiri dari kombinasi teks harfiah dan substitusi. Penggantian adalah satu-satunya elemen bahasa ekspresi reguler yang dikenali dalam pola pengganti.

Karena metode mengembalikan input tidak berubah jika tidak ada kecocokan ReferenceEquals(Object, Object) , Anda dapat menggunakan metode untuk menentukan apakah metode telah membuat penggantian apa pun.

Lihat juga

Berlaku untuk

Replace(String, MatchEvaluator, Int32)

Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs
Sumber:
Regex.Replace.cs

Dalam string input tertentu, menggantikan jumlah maksimum string tertentu yang cocok dengan pola ekspresi reguler dengan string yang MatchEvaluator dikembalikan oleh delegasi.

public:
 System::String ^ Replace(System::String ^ input, System::Text::RegularExpressions::MatchEvaluator ^ evaluator, int count);
public string Replace(string input, System.Text.RegularExpressions.MatchEvaluator evaluator, int count);
member this.Replace : string * System.Text.RegularExpressions.MatchEvaluator * int -> string
Public Function Replace (input As String, evaluator As MatchEvaluator, count As Integer) As String

Parameter

input
String

String untuk mencari kecocokan.

evaluator
MatchEvaluator

Metode kustom yang memeriksa setiap kecocokan dan mengembalikan string asli yang cocok atau string pengganti.

count
Int32

Jumlah maksimum kali penggantian akan terjadi.

Mengembalikan

String baru yang identik dengan string input, kecuali bahwa string pengganti menggantikan setiap string yang cocok. Jika pola ekspresi reguler tidak cocok dalam instans saat ini, metode mengembalikan instans saat ini tidak berubah.

Pengecualian

input atau evaluator adalah null.

Waktu habis terjadi.

Keterangan

Metode ini berguna untuk mengganti kecocokan ekspresi reguler jika salah satu kondisi berikut ini benar: string pengganti tidak dapat dengan mudah ditentukan oleh pola penggantian ekspresi reguler, hasil string pengganti dari pemrosesan string yang cocok, atau string pengganti hasil dari pemrosesan bersyariah.

Metode ini setara dengan memanggil Matches(String) metode dan meneruskan objek pertama countMatch dalam yang dikembalikan MatchCollection ke evaluator delegasi.

Jika count negatif, penggantian berlanjut ke akhir string.

Karena metode mengembalikan input tidak berubah jika tidak ada kecocokan ReferenceEquals(Object, Object) , Anda dapat menggunakan metode untuk menentukan apakah metode telah membuat penggantian apa pun.

Lihat juga

Berlaku untuk