Regex.Replace Yöntem

Tanım

Ad Alanı:

System.Text.RegularExpressions

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Text.RegularExpressions.dll

Belirtilen bir giriş dizesinde, normal ifade deseniyle eşleşen dizeleri belirtilen bir değiştirme dizesiyle değiştirir.

Aşırı Yüklemeler

Name	Description
Replace(String, String, String, RegexOptions)	Belirtilen bir giriş dizesinde, belirtilen normal ifadeyle eşleşen tüm dizeleri belirtilen bir değiştirme dizesiyle değiştirir. Belirtilen seçenekler eşleşen işlemi değiştirir.
Replace(String, String, String, RegexOptions, TimeSpan)	Belirtilen bir giriş dizesinde, belirtilen normal ifadeyle eşleşen tüm dizeleri belirtilen bir değiştirme dizesiyle değiştirir. Ek parametreler, eşleşen işlemi değiştiren seçenekleri ve eşleşme bulunamazsa zaman aşımı aralığını belirtir.
Replace(String, MatchEvaluator, Int32, Int32)	Belirtilen bir giriş alt dizesinde, normal ifade deseniyle eşleşen belirtilen en fazla sayıda dizeyi bir temsilci tarafından MatchEvaluator döndürülen bir dizeyle değiştirir.
Replace(String, String, MatchEvaluator, RegexOptions)	Belirtilen giriş dizesinde, belirtilen normal ifadeyle eşleşen tüm dizeleri bir MatchEvaluator temsilci tarafından döndürülen bir dizeyle değiştirir. Belirtilen seçenekler eşleşen işlemi değiştirir.
Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan)	Belirtilen giriş dizesinde, belirtilen normal ifadeyle eşleşen tüm alt dizeleri bir temsilci tarafından döndürülen bir MatchEvaluator dizeyle değiştirir. Ek parametreler, eşleşen işlemi değiştiren seçenekleri ve eşleşme bulunamazsa zaman aşımı aralığını belirtir.
Replace(String, String, Int32, Int32)	Belirtilen bir giriş alt dizesinde, normal ifade deseniyle eşleşen belirtilen en fazla dize sayısını belirtilen değiştirme dizesiyle değiştirir.
Replace(String, String, String)	Belirtilen bir giriş dizesinde, belirtilen normal ifadeyle eşleşen tüm dizeleri belirtilen bir değiştirme dizesiyle değiştirir.
Replace(String, String, MatchEvaluator)	Belirtilen giriş dizesinde, belirtilen normal ifadeyle eşleşen tüm dizeleri bir MatchEvaluator temsilci tarafından döndürülen bir dizeyle değiştirir.
Replace(String, String, Int32)	Belirtilen bir giriş dizesinde, normal ifade deseniyle eşleşen belirtilen en fazla sayıda dizeyi belirtilen bir değiştirme dizesiyle değiştirir.
Replace(String, MatchEvaluator)	Belirtilen giriş dizesinde, belirtilen normal ifadeyle eşleşen tüm dizeleri bir MatchEvaluator temsilci tarafından döndürülen bir dizeyle değiştirir.
Replace(String, String)	Belirtilen bir giriş dizesinde, normal ifade deseniyle eşleşen tüm dizeleri belirtilen bir değiştirme dizesiyle değiştirir.
Replace(String, MatchEvaluator, Int32)	Belirtilen giriş dizesinde, normal ifade deseniyle eşleşen belirtilen en fazla sayıda dizeyi bir temsilci tarafından MatchEvaluator döndürülen bir dizeyle değiştirir.

Replace(String, String, String, RegexOptions)

Kaynak:

Regex.Replace.cs

Belirtilen bir giriş dizesinde, belirtilen normal ifadeyle eşleşen tüm dizeleri belirtilen bir değiştirme dizesiyle değiştirir. Belirtilen seçenekler eşleşen işlemi değiştirir.

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

Parametreler

input

String

Eşleşme aranacak dize.

pattern

String

Eşleşecek normal ifade deseni.

replacement

String

Değiştirme dizesi.

options

RegexOptions

Eşleştirme seçenekleri sağlayan numaralandırma değerlerinin bit düzeyinde birleşimi.

Döndürülenler

String

Değiştirilen dizenin eşleşen her dizenin yerini alması dışında giriş dizesiyle aynı olan yeni bir dize. Geçerli örnekte eşleşmezse pattern , yöntemi geçerli örneği değişmeden döndürür.

Özel durumlar

ArgumentException

Normal ifade ayrıştırma hatası oluştu.

ArgumentNullException

input, patternveya replacement şeklindedir null.

ArgumentOutOfRangeException

options değerlerin RegexOptions bit düzeyinde geçerli bir bileşimi değildir.

RegexMatchTimeoutException

Zaman aşımı oluştu. Zaman aşımları hakkında daha fazla bilgi için Açıklamalar bölümüne bakın.

Örnekler

Aşağıdaki örnek, bir UNC yolundaki yerel makine ve sürücü adlarını yerel dosya yolu ile değiştirmek için yöntemini kullanır Replace(String, String, String, RegexOptions) . Normal ifade, yerel bilgisayarın adını eklemek için özelliğini ve Environment.GetLogicalDrives mantıksal sürücülerin adlarını eklemek için yöntemini kullanırEnvironment.MachineName. Tüm normal ifade dizesi karşılaştırmaları büyük/küçük harfe duyarlı değildir. Örneği başarıyla çalıştırmak için "MyMachine" değişmez dizesini yerel makine adınızla değiştirmeniz gerekir.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      // Get drives available on local computer and form into a single character expression.
      string[] drives = Environment.GetLogicalDrives();
      string driveNames = String.Empty;
      foreach (string drive in drives)
         driveNames += drive.Substring(0,1);
      // Create regular expression pattern dynamically based on local machine information.
      string pattern = @"\\\\" + Environment.MachineName + @"(?:\.\w+)*\\([" + driveNames + @"])\$";

      string replacement = "$1:";
      string[] uncPaths = { @"\\MyMachine.domain1.mycompany.com\C$\ThingsToDo.txt", 
                            @"\\MyMachine\c$\ThingsToDo.txt", 
                            @"\\MyMachine\d$\documents\mydocument.docx" }; 
      
      foreach (string uncPath in uncPaths)
      {
         Console.WriteLine("Input string: " + uncPath);
         Console.WriteLine("Returned string: " + Regex.Replace(uncPath, pattern, replacement, RegexOptions.IgnoreCase));
         Console.WriteLine();
      }
   }
}
// The example displays the following output if run on a machine whose name is
// MyMachine:
//    Input string: \\MyMachine.domain1.mycompany.com\C$\ThingsToTo.txt
//    Returned string: C:\ThingsToDo.txt
//    
//    Input string: \\MyMachine\c$\ThingsToDo.txt
//    Returned string: c:\ThingsToDo.txt
//    
//    Input string: \\MyMachine\d$\documents\mydocument.docx
//    Returned string: d:\documents\mydocument.docx

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      ' Get drives available on local computer and form into a single character expression.
      Dim drives() As String = Environment.GetLogicalDrives()
      Dim driveNames As String = Nothing
      For Each drive As String In drives
         driveNames += drive.Substring(0,1)
      Next
      ' Create regular expression pattern dynamically based on local machine information.
      Dim pattern As String = "\\\\" + Environment.MachineName + "(?:\.\w+)*\\([" + driveNames + "])\$"

      Dim replacement As String = "$1:"
      Dim uncPaths() AS String = {"\\MyMachine.domain1.mycompany.com\C$\ThingsToDo.txt", _
                                  "\\MyMachine\c$\ThingsToDo.txt", _
                                  "\\MyMachine\d$\documents\mydocument.docx" } 
      
      For Each uncPath As String In uncPaths
         Console.WriteLine("Input string: " + uncPath)
         Console.WriteLine("Returned string: " + Regex.Replace(uncPath, pattern, replacement, RegexOptions.IgnoreCase))
         Console.WriteLine()
      Next
   End Sub
End Module
' The example displays the following output if run on a machine whose name is
' MyMachine:
'    Input string: \\MyMachine.domain1.mycompany.com\C$\ThingsToTo.txt
'    Returned string: C:\ThingsToDo.txt
'    
'    Input string: \\MyMachine\c$\ThingsToDo.txt
'    Returned string: c:\ThingsToDo.txt
'    
'    Input string: \\MyMachine\d$\documents\mydocument.docx
'    Returned string: d:\documents\mydocument.docx

Normal ifade deseni aşağıdaki ifadeyle tanımlanır:

"\\\\" + Environment.MachineName + "(?:\.\w+)*\\([" + driveNames + "])\$"

Aşağıdaki tabloda normal ifade deseninin nasıl yorumlandığı gösterilmektedir.

Desen	Tarif
\\\\	İki ardışık ters eğik çizgi (\) karakteri eşleştirin. Ters eğik çizgi karakteri kaçış karakteri olarak yorumlandığından, her ters eğik çizginin başka bir ters eğik çizgiyle kaçış karakteri olması gerekir.
+ Environment.MachineName +	özelliği tarafından döndürülen dizeyi eşleştirin Environment.MachineName .
(?:\.\w+)*	Nokta (.) karakterini ve ardından bir veya daha fazla sözcük karakterini eşleştirin. Bu eşleşme sıfır veya daha fazla kez gerçekleşebilir. Eşleşen alt ifade yakalanmaz.
\\	Ters eğik çizgi (\) karakterini eşleştirin.
([" + driveNames + "])	Tek tek sürücü harflerinden oluşan karakter sınıfını eşleştirin. Bu eşleşme, yakalanan ilk alt ifadedir.
\$	Sabit dolar işareti ($) karakterini eşleştirin.

Değiştirme düzeni $1 , eşleşmenin tamamını yakalanan ilk alt ifadeyle değiştirir. Yani, UNC makinesini ve sürücü adını sürücü harfiyle değiştirir.

Açıklamalar

Statik Replace yöntemler, belirtilen normal ifade desenine sahip bir Regex nesne oluşturmak ve örnek yöntemini çağırmakla eşdeğerdir Replace.

parametresi, pattern eşleşecek dizeyi simgesel olarak tanımlayan normal ifade dili öğelerinden oluşur. Normal ifadeler hakkında daha fazla bilgi için bkz. .NET Normal İfadeleri ve Normal İfade Dili - Hızlı Başvuru. parametresini options belirtirsenizRightToLeft, eşleşme araması giriş dizesinin sonunda başlar ve sola taşınır; aksi takdirde, arama giriş dizesinin başlangıcında başlar ve sağa taşınır.

parametresi içindeki replacement her eşleşmenin inputdeğiştirilme dizesini belirtir. replacement değişmez metin ve değiştirmelerin herhangi bir bileşiminden oluşabilir. Örneğin, değiştirme deseni a*${test}b "a*" dizesini ve ardından yakalama grubuyla test eşleşen alt dizeyi (varsa) ve ardından "b" dizesini ekler. * karakteri, değiştirme deseni içinde meta karakter olarak tanınmaz.

Not

Değiştirmeler, değiştirme deseninde tanınan tek normal ifade dili öğeleridir. Karakter kaçışları da dahil olmak üzere diğer tüm normal ifade dili öğelerine yalnızca normal ifade desenlerinde izin verilir ve değiştirme desenlerinde tanınmaz.

Değiştirme RegexMatchTimeoutException işleminin yürütme süresi yöntemin çağrıldığı uygulama etki alanı için belirtilen zaman aşımı aralığını aşarsa özel durum oluşturulur. Uygulama etki alanının özelliklerinde zaman aşımı tanımlanmamışsa veya zaman aşımı değeri ise Regex.InfiniteMatchTimeoutözel durum oluşturmaz.

Eşleşme yoksa yöntemi değişmeden döndürdüğünden input , yöntemini kullanarak yöntemin Object.ReferenceEquals giriş dizesinde herhangi bir değişiklik yapıp yapmadığını belirleyebilirsiniz.

Arayanlara Notlar

Bu yöntem, çağrıldığı uygulama etki alanının varsayılan zaman aşımı değerine eşit bir aralıktan sonra zaman aşımına uğradı. Uygulama etki alanı için zaman aşımı değeri tanımlanmamışsa, yönteminin zaman aşımına girmesini engelleyen değeri InfiniteMatchTimeoutkullanılır. Bir desen eşleşmesini değiştirmek için önerilen statik yöntem, zaman aşımı aralığını ayarlamanıza olanak tanıyan yöntemidir Replace(String, String, String, RegexOptions, TimeSpan).

Ayrıca bkz.

• RegexOptions
• Normal İfadelerdeki Değişimler
• Normal İfade Dili Öğeleri

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

Kaynak:

Regex.Replace.cs

Belirtilen bir giriş dizesinde, belirtilen normal ifadeyle eşleşen tüm dizeleri belirtilen bir değiştirme dizesiyle değiştirir. Ek parametreler, eşleşen işlemi değiştiren seçenekleri ve eşleşme bulunamazsa zaman aşımı aralığını belirtir.

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

Parametreler

input

String

Eşleşme aranacak dize.

pattern

String

Eşleşecek normal ifade deseni.

replacement

String

Değiştirme dizesi.

options

RegexOptions

Eşleştirme seçenekleri sağlayan numaralandırma değerlerinin bit düzeyinde birleşimi.

matchTimeout

TimeSpan

Zaman aşımı aralığı veya InfiniteMatchTimeout yöntemin zaman aşımına neden olmaması gerektiğini belirtmek için.

Döndürülenler

String

Değiştirilen dizenin eşleşen her dizenin yerini alması dışında giriş dizesiyle aynı olan yeni bir dize. Geçerli örnekte eşleşmezse pattern , yöntemi geçerli örneği değişmeden döndürür.

Özel durumlar

ArgumentException

Normal ifade ayrıştırma hatası oluştu.

ArgumentNullException

input, patternveya replacement şeklindedir null.

ArgumentOutOfRangeException

options değerlerin RegexOptions bit düzeyinde geçerli bir bileşimi değildir.

-veya-

matchTimeout negatif, sıfır veya yaklaşık 24 günden uzundur.

RegexMatchTimeoutException

Zaman aşımı oluştu. Zaman aşımları hakkında daha fazla bilgi için Açıklamalar bölümüne bakın.

Örnekler

Aşağıdaki örnek, bir UNC yolundaki yerel makine ve sürücü adlarını yerel dosya yolu ile değiştirmek için yöntemini kullanır Replace(String, String, String, RegexOptions, TimeSpan) . Normal ifade, yerel bilgisayarın adını ve Environment.GetLogicalDrives mantıksal sürücülerin adlarını eklemek için yöntemini eklemek için özelliğini kullanırEnvironment.MachineName. Tüm normal ifade dizesi karşılaştırmaları büyük/küçük harfe duyarlı değildir ve eşleşme 0,5 saniye içinde bulunamazsa tek değiştirme işlemleri zaman aşımına ular. Örneği başarıyla çalıştırmak için "MyMachine" değişmez dizesini yerel makine adınızla değiştirmeniz gerekir.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      // Get drives available on local computer and form into a single character expression.
      string[] drives = Environment.GetLogicalDrives();
      string driveNames = String.Empty;
      foreach (string drive in drives)
         driveNames += drive.Substring(0,1);
      // Create regular expression pattern dynamically based on local machine information.
      string pattern = @"\\\\" + Environment.MachineName + @"(?:\.\w+)*\\([" + driveNames + @"])\$";

      string replacement = "$1:";
      string[] uncPaths = { @"\\MyMachine.domain1.mycompany.com\C$\ThingsToDo.txt", 
                            @"\\MyMachine\c$\ThingsToDo.txt", 
                            @"\\MyMachine\d$\documents\mydocument.docx" }; 
      
      foreach (string uncPath in uncPaths)
      {
         Console.WriteLine("Input string: " + uncPath);
         string localPath = null;
         try {
            localPath = Regex.Replace(uncPath, pattern, replacement, 
                                      RegexOptions.IgnoreCase,
                                      TimeSpan.FromSeconds(0.5));
            Console.WriteLine("Returned string: " + localPath);
         }
         catch (RegexMatchTimeoutException) {
            Console.WriteLine("The replace operation timed out.");
            Console.WriteLine("Returned string: " + localPath);
            if (uncPath.Equals(localPath)) 
               Console.WriteLine("Equal to original path.");
            else
               Console.WriteLine("Original string: " + uncPath);
         }
         Console.WriteLine();
      }
   }
}
// The example displays the following output if run on a machine whose name is
// MyMachine:
//    Input string: \\MyMachine.domain1.mycompany.com\C$\ThingsToTo.txt
//    Returned string: C:\ThingsToDo.txt
//    
//    Input string: \\MyMachine\c$\ThingsToDo.txt
//    Returned string: c:\ThingsToDo.txt
//    
//    Input string: \\MyMachine\d$\documents\mydocument.docx
//    Returned string: d:\documents\mydocument.docx

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      ' Get drives available on local computer and form into a single character expression.
      Dim drives() As String = Environment.GetLogicalDrives()
      Dim driveNames As String = Nothing
      For Each drive As String In drives
         driveNames += drive.Substring(0,1)
      Next
      ' Create regular expression pattern dynamically based on local machine information.
      Dim pattern As String = "\\\\" + Environment.MachineName + "(?:\.\w+)*\\([" + driveNames + "])\$"

      Dim replacement As String = "$1:"
      Dim uncPaths() AS String = {"\\MyMachine.domain1.mycompany.com\C$\ThingsToDo.txt", _
                                  "\\MyMachine\c$\ThingsToDo.txt", _
                                  "\\MyMachine\d$\documents\mydocument.docx" } 
      
      For Each uncPath As String In uncPaths
         Console.WriteLine("Input string: " + uncPath)
         Dim localPath As String = Nothing
         Try
            localPath = Regex.Replace(uncPath, pattern, replacement, 
                                                               RegexOptions.IgnoreCase,
                                                               TimeSpan.FromSeconds(0.5))
            Console.WriteLine("Returned string: " + localPath)         
         Catch e As RegexMatchTimeoutException
            Console.WriteLine("The replace operation timed out.")
            Console.WriteLine("Returned string: " + localPath)
            If uncPath.Equals(localPath) Then 
               Console.WriteLine("Equal to original path.")
            Else
               Console.WriteLine("Original string: " + uncPath)
            End If
         End Try         
         Console.WriteLine()
      Next
   End Sub
End Module
' The example displays the following output if run on a machine whose name is
' MyMachine:
'    Input string: \\MyMachine.domain1.mycompany.com\C$\ThingsToTo.txt
'    Returned string: C:\ThingsToDo.txt
'    
'    Input string: \\MyMachine\c$\ThingsToDo.txt
'    Returned string: c:\ThingsToDo.txt
'    
'    Input string: \\MyMachine\d$\documents\mydocument.docx
'    Returned string: d:\documents\mydocument.docx

Normal ifade deseni aşağıdaki ifadeyle tanımlanır:

"\\\\" + Environment.MachineName + "(?:\.\w+)*\\([" + driveNames + "])\$"

Aşağıdaki tabloda normal ifade deseninin nasıl yorumlandığı gösterilmektedir.

Desen	Tarif
\\\\	İki ardışık ters eğik çizgi (\) karakteri eşleştirin. Ters eğik çizgi karakteri kaçış karakteri olarak yorumlandığından, her ters eğik çizginin başka bir ters eğik çizgiyle kaçış karakteri olması gerekir.
+ Environment.MachineName +	özelliği tarafından döndürülen dizeyi eşleştirin Environment.MachineName .
(?:\.\w+)*	Nokta (.) karakterini ve ardından bir veya daha fazla sözcük karakterini eşleştirin. Bu eşleşme sıfır veya daha fazla kez gerçekleşebilir. Eşleşen alt ifade yakalanmaz.
\\	Ters eğik çizgi (\) karakterini eşleştirin.
([" + driveNames + "])	Tek tek sürücü harflerinden oluşan karakter sınıfını eşleştirin. Bu eşleşme, yakalanan ilk alt ifadedir.
\$	Sabit dolar işareti ($) karakterini eşleştirin.

Değiştirme düzeni $1 , eşleşmenin tamamını yakalanan ilk alt ifadeyle değiştirir. Yani, UNC makinesini ve sürücü adını sürücü harfiyle değiştirir.

Açıklamalar

Statik Replace yöntemler, belirtilen normal ifade desenine sahip bir Regex nesne oluşturmak ve örnek yöntemini çağırmakla eşdeğerdir Replace.

parametresi, pattern eşleşecek dizeyi simgesel olarak tanımlayan normal ifade dili öğelerinden oluşur. Normal ifadeler hakkında daha fazla bilgi için bkz. .NET Normal İfadeleri ve Normal İfade Dili - Hızlı Başvuru. parametresini options belirtirsenizRightToLeft, eşleşme araması giriş dizesinin sonunda başlar ve sola taşınır; aksi takdirde, arama giriş dizesinin başlangıcında başlar ve sağa taşınır.

parametresi içindeki replacement her eşleşmenin inputdeğiştirilme dizesini belirtir. replacement değişmez metin ve değiştirmelerin herhangi bir bileşiminden oluşabilir. Örneğin, değiştirme deseni a*${test}b "a*" dizesini ve ardından yakalama grubuyla test eşleşen alt dizeyi (varsa) ve ardından "b" dizesini ekler. * karakteri, değiştirme deseni içinde meta karakter olarak tanınmaz.

Not

Değiştirmeler, değiştirme deseninde tanınan tek normal ifade dili öğeleridir. Karakter kaçışları da dahil olmak üzere diğer tüm normal ifade dili öğelerine yalnızca normal ifade desenlerinde izin verilir ve değiştirme desenlerinde tanınmaz.

parametresi, matchTimeout desen eşleştirme yönteminin zaman aşımına uğramadan önce eşleşmeyi ne kadar süreyle bulmaya çalışılması gerektiğini belirtir. Zaman aşımı aralığı ayarlamak, aşırı geri izleme kullanan normal ifadelerin, yakın eşleşmeler içeren girişleri işlerken yanıt vermeyi durdurmak için görünmesini engeller. Daha fazla bilgi için bkz. Normal İfadeler ve Geri İzlemeiçin En İyi Yöntemler. Bu zaman aralığında eşleşme bulunmazsa, yöntem bir RegexMatchTimeoutException özel durum oluşturur. matchTimeout yönteminin yürütüldiği uygulama etki alanı için tanımlanan varsayılan zaman aşımı değerlerini geçersiz kılar.

Eşleşme yoksa yöntemi değişmeden döndürdüğünden input , yöntemini kullanarak yöntemin Object.ReferenceEquals giriş dizesinde herhangi bir değişiklik yapıp yapmadığını belirleyebilirsiniz.

Arayanlara Notlar

parametresini matchTimeout iki saniye gibi uygun bir değere ayarlamanızı öneririz. belirterek InfiniteMatchTimeoutzaman aşımlarını devre dışı bırakırsanız normal ifade altyapısı biraz daha iyi performans sunar. Ancak, zaman aşımlarını yalnızca aşağıdaki koşullar altında devre dışı bırakmalısınız:

• Normal bir ifade tarafından işlenen giriş bilinen ve güvenilen bir kaynaktan türetildiğinde veya statik metinden oluştuğunda. Bu, kullanıcılar tarafından dinamik olarak giriş yapılan metinleri dışlar.

• Normal ifade deseni, eşleşmeleri, eşleşme olmayanları ve yakın eşleşmeleri verimli bir şekilde işlediğinden emin olmak için kapsamlı bir şekilde test edildiğinde.

• Normal ifade deseni, yakın bir eşleşmeyi işlerken aşırı geri dönüşe neden olduğu bilinen bir dil öğesi içermediğinde.

Ayrıca bkz.

• RegexOptions
• Normal İfadelerdeki Değişimler
• Normal İfade Dili Öğeleri
• Normal İfadelerde Geri İzleme
• .NET'te normal ifadeler için en iyi yöntemler

Replace(String, MatchEvaluator, Int32, Int32)

Kaynak:

Regex.Replace.cs

Belirtilen bir giriş alt dizesinde, normal ifade deseniyle eşleşen belirtilen en fazla sayıda dizeyi bir temsilci tarafından MatchEvaluator döndürülen bir dizeyle değiştirir.

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

Parametreler

input

String

Eşleşme aranacak dize.

evaluator

MatchEvaluator

Her eşleşmeyi inceleyen ve özgün eşleşen dizeyi veya değiştirme dizesini döndüren özel bir yöntem.

count

Int32

Değiştirmenin en fazla kaç kez gerçekleşeceği.

startat

Int32

Aramanın başladığı giriş dizesindeki karakter konumu.

Döndürülenler

String

Eşleşen her dizenin yerini bir değiştirme dizesinin alması dışında giriş dizesiyle aynı olan yeni bir dize. Normal ifade deseni geçerli örnekte eşleşmiyorsa, yöntemi geçerli örneği değişmeden döndürür.

Özel durumlar

ArgumentNullException

input veya evaluator şeklindedir null.

ArgumentOutOfRangeException

startatsıfırdan küçük veya uzunluğundan büyük.input

RegexMatchTimeoutException

Zaman aşımı oluştu. Zaman aşımları hakkında daha fazla bilgi için Açıklamalar bölümüne bakın.

Açıklamalar

yöntemi, Regex.Replace(String, MatchEvaluator, Int32, Int32) aşağıdaki koşullardan biri doğruysa normal ifade eşleşmesini değiştirmek için kullanışlıdır:

• Değiştirme dizesi, normal ifade değiştirme deseni tarafından hazır olarak belirtilemez.
• Değiştirme dizesi, eşleşen dizede yapılan bazı işlemlerden kaynaklanır.
• Değiştirme dizesi koşullu işleme sonucu verir.

yöntemi, yöntemini çağırmak Regex.Matches(String, Int32) ve döndürülen MatchCollection koleksiyondaki ilk countMatch nesneleri temsilciye geçirmekle evaluator eşdeğerdir.

hakkında startatdaha fazla ayrıntı için, öğesinin Açıklamalar bölümüne Match(String, Int32)bakın.

Normal ifade, geçerli Regex nesne için oluşturucu tarafından tanımlanan desendir.

evaluator parametresi, tanımladığınız ve her eşleşmeyi inceleyen özel bir yöntemin temsilcisidir. Özel yöntemin temsilciyle eşleşmesi için aşağıdaki imzaya MatchEvaluator sahip olması gerekir.

public string MatchEvaluatorMethod(Match match)

Public Function MatchEvaluatorMethod(match As Match) As String

Özel yönteminiz, eşleşen girişin yerini alan bir dize döndürür.

RegexMatchTimeoutException Değiştirme işleminin yürütme süresi oluşturucu tarafından Regex.Regex(String, RegexOptions, TimeSpan) belirtilen zaman aşımı aralığını aşarsa özel durum oluşturulur. Oluşturucuyu çağırdığınızda zaman aşımı aralığı ayarlamazsanız, işlem Regex nesnesinin oluşturulduğu uygulama etki alanı için belirlenen zaman aşımı değerini aşarsa özel durum oluşturulur. Oluşturucu çağrısında veya uygulama etki alanının özelliklerinde Regex zaman aşımı tanımlanmadıysa ya da zaman aşımı değeri ise Regex.InfiniteMatchTimeoutözel durum oluşturmaz

Eşleşme yoksa yöntemi değişmeden döndürdüğünden input , yöntemini kullanarak yöntemin Object.ReferenceEquals giriş dizesinde herhangi bir değişiklik yapıp yapmadığını belirleyebilirsiniz.

Ayrıca bkz.

• MatchEvaluator
• Normal İfadelerdeki Değişimler
• Düzenli İfade Dili - Hızlı Referans

Replace(String, String, MatchEvaluator, RegexOptions)

Kaynak:

Regex.Replace.cs

Belirtilen giriş dizesinde, belirtilen normal ifadeyle eşleşen tüm dizeleri bir MatchEvaluator temsilci tarafından döndürülen bir dizeyle değiştirir. Belirtilen seçenekler eşleşen işlemi değiştirir.

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

Parametreler

input

String

Eşleşme aranacak dize.

pattern

String

Eşleşecek normal ifade deseni.

evaluator

MatchEvaluator

Her eşleşmeyi inceleyen ve özgün eşleşen dizeyi veya değiştirme dizesini döndüren özel bir yöntem.

options

RegexOptions

Eşleştirme seçenekleri sağlayan numaralandırma değerlerinin bit düzeyinde birleşimi.

Döndürülenler

String

Eşleşen her dizenin yerini bir değiştirme dizesinin alması dışında giriş dizesiyle aynı olan yeni bir dize. Geçerli örnekte eşleşmezse pattern , yöntemi geçerli örneği değişmeden döndürür.

Özel durumlar

ArgumentException

Normal ifade ayrıştırma hatası oluştu.

ArgumentNullException

input, patternveya evaluator şeklindedir null.

ArgumentOutOfRangeException

options değerlerin RegexOptions bit düzeyinde geçerli bir bileşimi değildir.

RegexMatchTimeoutException

Zaman aşımı oluştu. Zaman aşımları hakkında daha fazla bilgi için Açıklamalar bölümüne bakın.

Örnekler

Aşağıdaki örnek, bir dizedeki tek tek sözcükleri ayıklamak için normal bir ifade kullanır ve ardından bir temsilci kullanarak MatchEvaluator sözcükteki tek tek harfleri karıştıran adlı WordScramble bir yöntemi çağırır. Bunu yapmak için yöntemi, WordScramble eşleşmedeki karakterleri içeren bir dizi oluşturur. Ayrıca rastgele kayan nokta sayılarıyla dolduran paralel bir dizi oluşturur. Diziler yöntemi çağrılarak Array.Sort<TKey,TValue>(TKey[], TValue[], IComparer<TKey>) sıralanır ve sıralanan dizi bir String sınıf oluşturucusunun bağımsız değişkeni olarak sağlanır. Bu yeni oluşturulan dize daha sonra yöntemi tarafından WordScramble döndürülür. Normal ifade deseni \w+ bir veya daha fazla sözcük karakteriyle eşleşir; normal ifade altyapısı, boşluk karakteri gibi sözcük olmayan bir karakterle karşılaşana kadar eşleşmeye karakter eklemeye devam eder. yöntemine Replace(String, String, MatchEvaluator, RegexOptions) yapılan çağrı, normal ifade desenindeki \w+ # Matches all the characters in a word. açıklamanın normal ifade altyapısı tarafından yoksayılarak seçeneğini içerirRegexOptions.IgnorePatternWhitespace.

using System;
using System.Collections;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string words = "letter alphabetical missing lack release " + 
                     "penchant slack acryllic laundry cease";
      string pattern = @"\w+  # Matches all the characters in a word.";                            
      MatchEvaluator evaluator = new MatchEvaluator(WordScrambler);
      Console.WriteLine("Original words:");
      Console.WriteLine(words);
      Console.WriteLine();
      Console.WriteLine("Scrambled words:");
      Console.WriteLine(Regex.Replace(words, pattern, evaluator, 
                                      RegexOptions.IgnorePatternWhitespace));      
   }

   public static string WordScrambler(Match match)
   {
      int arraySize = match.Value.Length;
      // Define two arrays equal to the number of letters in the match.
      double[] keys = new double[arraySize];
      char[] letters = new char[arraySize];
      
      // Instantiate random number generator'
      Random rnd = new Random();
      
      for (int ctr = 0; ctr < match.Value.Length; ctr++)
      {
         // Populate the array of keys with random numbers.
         keys[ctr] = rnd.NextDouble();
         // Assign letter to array of letters.
         letters[ctr] = match.Value[ctr];
      }         
      Array.Sort(keys, letters, 0, arraySize, Comparer.Default);      
      return new String(letters);
   }
}
// The example displays output similar to the following:
//    Original words:
//    letter alphabetical missing lack release penchant slack acryllic laundry cease
//    
//    Scrambled words:
//    etlert liahepalbcat imsgsni alkc ereelsa epcnnaht lscak cayirllc alnyurd ecsae

Imports System.Collections
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim words As String = "letter alphabetical missing lack release " + _
                            "penchant slack acryllic laundry cease"
      Dim pattern As String = "\w+  # Matches all the characters in a word."                            
      Dim evaluator As MatchEvaluator = AddressOf WordScrambler
      Console.WriteLine("Original words:")
      Console.WriteLine(words)
      Console.WriteLine("Scrambled words:")
      Console.WriteLine(Regex.Replace(words, pattern, evaluator,
                                      RegexOptions.IgnorePatternWhitespace))      
   End Sub
   
   Public Function WordScrambler(match As Match) As String
      Dim arraySize As Integer = match.Value.Length - 1
      ' Define two arrays equal to the number of letters in the match.
      Dim keys(arraySize) As Double
      Dim letters(arraySize) As Char
      
      ' Instantiate random number generator'
      Dim rnd As New Random()
      
      For ctr As Integer = 0 To match.Value.Length - 1
         ' Populate the array of keys with random numbers.
         keys(ctr) = rnd.NextDouble()
         ' Assign letter to array of letters.
         letters(ctr) = match.Value.Chars(ctr)
      Next         
      Array.Sort(keys, letters, 0, arraySize, Comparer.Default)      
      Return New String(letters)
   End Function
End Module
' The example displays output similar to the following:
'    Original words:
'    letter alphabetical missing lack release penchant slack acryllic laundry cease
'    
'    Scrambled words:
'    etlert liahepalbcat imsgsni alkc ereelsa epcnnaht lscak cayirllc alnyurd ecsae

Açıklamalar

yöntemi Regex.Replace(String, String, MatchEvaluator, RegexOptions) , aşağıdaki koşullardan biri doğruysa içindeki normal ifade eşleşmesini değiştirmek için kullanışlıdır:

• Değiştirme dizesi, normal ifade değiştirme deseni tarafından hazır olarak belirtilemez.

• Değiştirme dizesi, eşleşen dizede yapılan bazı işlemlerden kaynaklanır.

• Değiştirme dizesi koşullu işleme sonucu verir.

yöntemi, yöntemini çağırmak Regex.Matches(String, String, RegexOptions) ve döndürülen MatchCollection koleksiyondaki her Match nesneyi temsilciye geçirmekle evaluator eşdeğerdir.

parametresi, pattern eşleşecek dizeyi simgesel olarak tanımlayan normal ifade dili öğelerinden oluşur. Normal ifadeler hakkında daha fazla bilgi için bkz. .NET Normal İfadeleri ve Normal İfade Dili - Hızlı Başvuru.

evaluator parametresi, tanımladığınız ve her eşleşmeyi inceleyen özel bir yöntemin temsilcisidir. Özel yöntemin temsilciyle eşleşmesi için aşağıdaki imzaya MatchEvaluator sahip olması gerekir.

public string MatchEvaluatorMethod(Match match)

Public Function MatchEvaluatorMethod(match As Match) As String

Özel yönteminiz, eşleşen girişin yerini alan bir dize döndürür.

parametresini options belirtirsenizRightToLeft, eşleşme araması giriş dizesinin sonunda başlar ve sola taşınır; aksi takdirde, arama giriş dizesinin başlangıcında başlar ve sağa taşınır.

Değiştirme RegexMatchTimeoutException işleminin yürütme süresi yöntemin çağrıldığı uygulama etki alanı için belirtilen zaman aşımı aralığını aşarsa özel durum oluşturulur. Uygulama etki alanının özelliklerinde zaman aşımı tanımlanmamışsa veya zaman aşımı değeri ise Regex.InfiniteMatchTimeoutözel durum oluşturmaz.

Eşleşme yoksa yöntemi değişmeden döndürdüğünden input , yöntemini kullanarak yöntemin Object.ReferenceEquals giriş dizesinde herhangi bir değişiklik yapıp yapmadığını belirleyebilirsiniz.

Ayrıca bkz.

• MatchEvaluator
• RegexOptions
• Normal İfadelerdeki Değişimler
• Normal İfade Dili Öğeleri

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

Kaynak:

Regex.Replace.cs

Belirtilen giriş dizesinde, belirtilen normal ifadeyle eşleşen tüm alt dizeleri bir temsilci tarafından döndürülen bir MatchEvaluator dizeyle değiştirir. Ek parametreler, eşleşen işlemi değiştiren seçenekleri ve eşleşme bulunamazsa zaman aşımı aralığını belirtir.

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

Parametreler

input

String

Eşleşme aranacak dize.

pattern

String

Eşleşecek normal ifade deseni.

evaluator

MatchEvaluator

Her eşleşmeyi inceleyen ve özgün eşleşen dizeyi veya değiştirme dizesini döndüren özel bir yöntem.

options

RegexOptions

Eşleştirme seçenekleri sağlayan sabit listesi değerlerinin bit düzeyinde birleşimi.

matchTimeout

TimeSpan

Zaman aşımı aralığı veya InfiniteMatchTimeout yöntemin zaman aşımına neden olmaması gerektiğini belirtmek için.

Döndürülenler

String

Değiştirilen dizenin eşleşen her dizenin yerini alması dışında giriş dizesiyle aynı olan yeni bir dize. Geçerli örnekte eşleşmezse pattern , yöntemi geçerli örneği değişmeden döndürür.

Özel durumlar

ArgumentException

Normal ifade ayrıştırma hatası oluştu.

ArgumentNullException

input, patternveya evaluator şeklindedir null.

ArgumentOutOfRangeException

options değerlerin RegexOptions bit düzeyinde geçerli bir bileşimi değildir.

-veya-

matchTimeout negatif, sıfır veya yaklaşık 24 günden uzundur.

RegexMatchTimeoutException

Zaman aşımı oluştu. Zaman aşımları hakkında daha fazla bilgi için Açıklamalar bölümüne bakın.

Örnekler

Aşağıdaki örnek, bir dizedeki tek tek sözcükleri ayıklamak için normal bir ifade kullanır ve ardından bir temsilci kullanarak MatchEvaluator sözcükteki tek tek harfleri karıştıran adlı WordScramble bir yöntemi çağırır. Bunu yapmak için yöntemi, WordScramble eşleşmedeki karakterleri içeren bir dizi oluşturur. Ayrıca rastgele kayan nokta sayılarıyla dolduran paralel bir dizi oluşturur. Diziler yöntemi çağrılarak Array.Sort<TKey,TValue>(TKey[], TValue[], IComparer<TKey>) sıralanır ve sıralanan dizi bir String sınıf oluşturucusunun bağımsız değişkeni olarak sağlanır. Bu yeni oluşturulan dize daha sonra yöntemi tarafından WordScramble döndürülür. Normal ifade deseni \w+ bir veya daha fazla sözcük karakteriyle eşleşir; normal ifade altyapısı, boşluk karakteri gibi sözcük olmayan bir karakterle karşılaşana kadar eşleşmeye karakter eklemeye devam eder. yöntemine Replace(String, String, MatchEvaluator, RegexOptions) yapılan çağrı, normal ifade desenindeki \w+ # Matches all the characters in a word. açıklamanın normal ifade altyapısı tarafından yoksayılarak seçeneğini içerirRegexOptions.IgnorePatternWhitespace.

using System;
using System.Collections;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string words = "letter alphabetical missing lack release " + 
                     "penchant slack acryllic laundry cease";
      string pattern = @"\w+  # Matches all the characters in a word.";                            
      MatchEvaluator evaluator = new MatchEvaluator(WordScrambler);
      Console.WriteLine("Original words:");
      Console.WriteLine(words);
      Console.WriteLine();
      try {
         Console.WriteLine("Scrambled words:");
         Console.WriteLine(Regex.Replace(words, pattern, evaluator, 
                                         RegexOptions.IgnorePatternWhitespace,
                                         TimeSpan.FromSeconds(.25)));      
      }
      catch (RegexMatchTimeoutException) {
         Console.WriteLine("Word Scramble operation timed out.");
         Console.WriteLine("Returned words:");
      }
   }

   public static string WordScrambler(Match match)
   {
      int arraySize = match.Value.Length;
      // Define two arrays equal to the number of letters in the match.
      double[] keys = new double[arraySize];
      char[] letters = new char[arraySize];
      
      // Instantiate random number generator'
      Random rnd = new Random();
      
      for (int ctr = 0; ctr < match.Value.Length; ctr++)
      {
         // Populate the array of keys with random numbers.
         keys[ctr] = rnd.NextDouble();
         // Assign letter to array of letters.
         letters[ctr] = match.Value[ctr];
      }         
      Array.Sort(keys, letters, 0, arraySize, Comparer.Default);      
      return new String(letters);
   }
}
// The example displays output similar to the following:
//    Original words:
//    letter alphabetical missing lack release penchant slack acryllic laundry cease
//    
//    Scrambled words:
//    etlert liahepalbcat imsgsni alkc ereelsa epcnnaht lscak cayirllc alnyurd ecsae

Imports System.Collections
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim words As String = "letter alphabetical missing lack release " + _
                            "penchant slack acryllic laundry cease"
      Dim pattern As String = "\w+  # Matches all the characters in a word."                            
      Dim evaluator As MatchEvaluator = AddressOf WordScrambler
      Console.WriteLine("Original words:")
      Console.WriteLine(words)
      Try
         Console.WriteLine("Scrambled words:")
         Console.WriteLine(Regex.Replace(words, pattern, evaluator,
                                         RegexOptions.IgnorePatternWhitespace,
                                         TimeSpan.FromSeconds(.25)))      
      Catch e As RegexMatchTimeoutException
         Console.WriteLine("Word Scramble operation timed out.")
         Console.WriteLine("Returned words:")
      End Try   
   End Sub
   
   Public Function WordScrambler(match As Match) As String
      Dim arraySize As Integer = match.Value.Length - 1
      ' Define two arrays equal to the number of letters in the match.
      Dim keys(arraySize) As Double
      Dim letters(arraySize) As Char
      
      ' Instantiate random number generator'
      Dim rnd As New Random()
      
      For ctr As Integer = 0 To match.Value.Length - 1
         ' Populate the array of keys with random numbers.
         keys(ctr) = rnd.NextDouble()
         ' Assign letter to array of letters.
         letters(ctr) = match.Value.Chars(ctr)
      Next         
      Array.Sort(keys, letters, 0, arraySize, Comparer.Default)      
      Return New String(letters)
   End Function
End Module
' The example displays output similar to the following:
'    Original words:
'    letter alphabetical missing lack release penchant slack acryllic laundry cease
'    
'    Scrambled words:
'    etlert liahepalbcat imsgsni alkc ereelsa epcnnaht lscak cayirllc alnyurd ecsae

Açıklamalar

yöntemi, Regex.Replace(String, String, MatchEvaluator, RegexOptions) aşağıdaki koşullardan biri doğruysa normal ifade eşleşmesini değiştirmek için kullanışlıdır:

• Değiştirme dizesi normal ifade değiştirme deseni tarafından kolayca belirtilemiyorsa.

• Değiştirilen dize, eşleşen dizede gerçekleştirilen bazı işlemlerden kaynaklanırsa.

• Değiştirme dizesi koşullu işlemeden kaynaklanırsa.

yöntemi, yöntemini çağırmak Regex.Matches(String, String, RegexOptions) ve döndürülen MatchCollection koleksiyondaki her Match nesneyi temsilciye geçirmekle evaluator eşdeğerdir.

parametresi, pattern eşleşecek dizeyi simgesel olarak tanımlayan normal ifade dili öğelerinden oluşur. Normal ifadeler hakkında daha fazla bilgi için bkz. .NET Normal İfadeleri ve Normal İfade Dili - Hızlı Başvuru.

evaluator parametresi, tanımladığınız ve her eşleşmeyi inceleyen özel bir yöntemin temsilcisidir. Özel yöntemin temsilciyle eşleşmesi için aşağıdaki imzaya MatchEvaluator sahip olması gerekir.

public string MatchEvaluatorMethod(Match match)

Public Function MatchEvaluatorMethod(match As Match) As String

Özel yönteminiz, eşleşen girişin yerini alan bir dize döndürür.

parametresini options belirtirsenizRightToLeft, eşleşme araması giriş dizesinin sonunda başlar ve sola taşınır; aksi takdirde, arama giriş dizesinin başlangıcında başlar ve sağa taşınır.

parametresi, matchTimeout desen eşleştirme yönteminin zaman aşımına uğramadan önce eşleşmeyi ne kadar süreyle bulmaya çalışılması gerektiğini belirtir. Zaman aşımı aralığının ayarlanması, aşırı geri izleme kullanan normal ifadelerin "yakın eşleşmeler içeren girişi işlerken yanıt vermeyi durdurma" olarak görünmesini önler. Daha fazla bilgi için bkz. Normal İfadeler ve Geri İzlemeiçin En İyi Yöntemler. Bu zaman aralığında eşleşme bulunmazsa, yöntem bir RegexMatchTimeoutException özel durum oluşturur. matchTimeout yönteminin yürütüldiği uygulama etki alanı için tanımlanan varsayılan zaman aşımı değerlerini geçersiz kılar.

Eşleşme yoksa yöntemi değişmeden döndürdüğünden input , yöntemini kullanarak yöntemin Object.ReferenceEquals giriş dizesinde herhangi bir değişiklik yapıp yapmadığını belirleyebilirsiniz.

Arayanlara Notlar

parametresini matchTimeout iki saniye gibi uygun bir değere ayarlamanızı öneririz. belirterek InfiniteMatchTimeoutzaman aşımlarını devre dışı bırakırsanız normal ifade altyapısı biraz daha iyi performans sunar. Ancak, zaman aşımlarını yalnızca aşağıdaki koşullar altında devre dışı bırakmalısınız:

• Normal bir ifade tarafından işlenen giriş bilinen ve güvenilen bir kaynaktan türetildiğinde veya statik metinden oluştuğunda. Bu, kullanıcılar tarafından dinamik olarak giriş yapılan metinleri dışlar.

• Normal ifade deseni, eşleşmeleri, eşleşme olmayanları ve yakın eşleşmeleri verimli bir şekilde işlediğinden emin olmak için kapsamlı bir şekilde test edildiğinde.

• Normal ifade deseni, yakın bir eşleşmeyi işlerken aşırı geri dönüşe neden olduğu bilinen bir dil öğesi içermediğinde.

Ayrıca bkz.

• RegexOptions
• Normal İfadelerdeki Değişimler
• Normal İfade Dili Öğeleri
• Normal İfadelerde Geri İzleme
• .NET'te normal ifadeler için en iyi yöntemler

Replace(String, String, Int32, Int32)

Kaynak:

Regex.Replace.cs

Belirtilen bir giriş alt dizesinde, normal ifade deseniyle eşleşen belirtilen en fazla dize sayısını belirtilen değiştirme dizesiyle değiştirir.

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

Parametreler

input

String

Eşleşme aranacak dize.

replacement

String

Değiştirme dizesi.

count

Int32

Değiştirmenin en fazla kaç kez gerçekleşebileceği.

startat

Int32

Aramanın başladığı giriş dizesindeki karakter konumu.

Döndürülenler

String

Değiştirilen dizenin eşleşen her dizenin yerini alması dışında giriş dizesiyle aynı olan yeni bir dize. Normal ifade deseni geçerli örnekte eşleşmiyorsa, yöntemi geçerli örneği değişmeden döndürür.

Özel durumlar

ArgumentNullException

input veya replacement şeklindedir null.

ArgumentOutOfRangeException

startatsıfırdan küçük veya uzunluğundan büyük.input

RegexMatchTimeoutException

Zaman aşımı oluştu. Zaman aşımları hakkında daha fazla bilgi için Açıklamalar bölümüne bakın.

Örnekler

Aşağıdaki örnek, bir dizenin ilk satırı dışında tümünü çift boşluklar. Bir metin satırıyla eşleşen bir normal ifade deseni ^.*$tanımlar, dizenin Match(String) ilk satırıyla eşleşmesi için yöntemini çağırır ve ikinci satırın başlangıç konumunu belirlemek için ve Match.Count özelliklerini kullanırMatch.Index.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = "Instantiating a New Type\n" +
                     "Generally, there are two ways that an\n" + 
                     "instance of a class or structure can\n" +
                     "be instantiated. ";
      string pattern = "^.*$";
      string replacement = "\n$&";
      Regex rgx = new Regex(pattern, RegexOptions.Multiline);
      string result = String.Empty; 
      
      Match match = rgx.Match(input);
      // Double space all but the first line.
      if (match.Success) 
         result = rgx.Replace(input, replacement, -1, match.Index + match.Length + 1);

      Console.WriteLine(result);                     
   }
}
// The example displays the following output:
//       Instantiating a New Type
//       
//       Generally, there are two ways that an
//       
//       instance of a class or structure can
//       
//       be instntiated.

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "Instantiating a New Type" + vbCrLf + _
                            "Generally, there are two ways that an" + vbCrLf + _
                            "instance of a class or structure can" + vbCrLf + _
                            "be instantiated. "
      Dim pattern As String = "^.*$"
      Dim replacement As String = vbCrLf + "$&"
      Dim rgx As New Regex(pattern, RegexOptions.Multiline)
      Dim result As String = String.Empty 
      
      Dim match As Match = rgx.Match(input)
      ' Double space all but the first line.
      If match.Success Then 
         result = rgx.Replace(input, replacement, -1, match.Index + match.Length + 1)
      End If
      Console.WriteLine(result)                      
   End Sub
End Module
' The example displays the following output:
'       Instantiating a New Type
'       
'       Generally, there are two ways that an
'       
'       instance of a class or structure can
'       
'       be instntiated.

Normal ifade deseni ^.*$ aşağıdaki tabloda gösterildiği gibi tanımlanır.

Desen	Tarif
^	Satırın başlangıcıyla eşleş. (Nesnenin Regex örneği seçeneği kullanılarak oluşturulduğunu RegexOptions.Multiline unutmayın; aksi takdirde, bu karakter sınıfı yalnızca giriş dizesinin başlangıcıyla eşleşer.)
.*	Herhangi bir karakteri sıfır veya daha fazla kez eşleştirin.
$	Satırın sonunu eşleştirin. (Nesnenin Regex örneği seçeneği kullanılarak oluşturulduğunu RegexOptions.Multiline unutmayın; aksi takdirde, bu karakter sınıfı yalnızca giriş dizesinin başlangıcıyla eşleşer.)

Değiştirilen dize (vbCrLf + "$&" Visual Basic'te, "\n$&" C# dilinde) eşleşen dizeden önce yeni bir satır ekler. \n C# örneğinde C# derleyicisi tarafından yeni satır karakteri olarak yorumlandığına dikkat edin; normal ifade karakteri çıkışını temsil etmez.

Açıklamalar

Eşleşme araması, dizede input parametresi tarafından startat belirtilen konumda başlar. Normal ifade, geçerli Regex nesne için oluşturucu tarafından tanımlanan desendir. Negatifse count , değiştirmeler dizenin sonuna kadar devam eder. Eşleşme sayısını aşarsa count , tüm eşleşmeler değiştirilir.

hakkında startatdaha fazla ayrıntı için, öğesinin Açıklamalar bölümüne Match(String, Int32)bakın.

parametresi içindeki replacement her eşleşmenin inputdeğiştirilme dizesini belirtir. replacement değişmez metin ve değiştirmelerin herhangi bir bileşiminden oluşabilir. Örneğin, değiştirme deseni a*${test}b "a*" dizesini ve ardından yakalama grubuyla test eşleşen alt dizeyi (varsa) ve ardından "b" dizesini ekler. * karakteri, değiştirme deseni içinde meta karakter olarak tanınmaz.

Not

Değiştirmeler, değiştirme deseninde tanınan tek normal ifade dili öğeleridir. Karakter kaçışları da dahil olmak üzere diğer tüm normal ifade dili öğelerine yalnızca normal ifade desenlerinde izin verilir ve değiştirme desenlerinde tanınmaz.

RegexMatchTimeoutException Değiştirme işleminin yürütme süresi oluşturucu tarafından Regex.Regex(String, RegexOptions, TimeSpan) belirtilen zaman aşımı aralığını aşarsa özel durum oluşturulur. Oluşturucuyu çağırdığınızda zaman aşımı aralığı ayarlamazsanız, işlem Regex nesnesinin oluşturulduğu uygulama etki alanı için belirlenen zaman aşımı değerini aşarsa özel durum oluşturulur. Oluşturucu çağrısında veya uygulama etki alanının özelliklerinde Regex zaman aşımı tanımlanmadıysa ya da zaman aşımı değeri ise Regex.InfiniteMatchTimeoutözel durum oluşturmaz

Eşleşme yoksa yöntemi değişmeden döndürdüğünden input , yöntemini kullanarak yöntemin Object.ReferenceEquals giriş dizesinde herhangi bir değişiklik yapıp yapmadığını belirleyebilirsiniz.

Ayrıca bkz.

• Normal İfadelerdeki Değişimler
• Düzenli İfade Dili - Hızlı Referans

Replace(String, String, String)

Kaynak:

Regex.Replace.cs

Belirtilen bir giriş dizesinde, belirtilen normal ifadeyle eşleşen tüm dizeleri belirtilen bir değiştirme dizesiyle değiştirir.

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

Parametreler

input

String

Eşleşme aranacak dize.

pattern

String

Eşleşecek normal ifade deseni.

replacement

String

Değiştirme dizesi.

Döndürülenler

String

Değiştirilen dizenin eşleşen her dizenin yerini alması dışında giriş dizesiyle aynı olan yeni bir dize. Geçerli örnekte eşleşmezse pattern , yöntemi geçerli örneği değişmeden döndürür.

Özel durumlar

ArgumentException

Normal ifade ayrıştırma hatası oluştu.

ArgumentNullException

input, patternveya replacement şeklindedir null.

RegexMatchTimeoutException

Zaman aşımı oluştu. Zaman aşımları hakkında daha fazla bilgi için Açıklamalar bölümüne bakın.

Örnekler

Aşağıdaki örnek, \s+bir veya daha fazla boşluk karakteriyle eşleşen normal ifadeyi tanımlar. " " yerine geçen dize, bunları tek bir boşluk karakteriyle değiştirir.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = "This is   text with   far  too   much   " + 
                     "white space.";
      string pattern = "\\s+";
      string replacement = " ";
      string result = Regex.Replace(input, pattern, replacement);
      
      Console.WriteLine("Original String: {0}", input);
      Console.WriteLine("Replacement String: {0}", result);                             
   }
}
// The example displays the following output:
//       Original String: This is   text with   far  too   much   white space.
//       Replacement String: This is text with far too much white space.

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "This is   text with   far  too   much   " + _
                            "white space."
      Dim pattern As String = "\s+"
      Dim replacement As String = " "
      Dim result As String = Regex.Replace(input, pattern, replacement)
      
      Console.WriteLine("Original String: {0}", input)
      Console.WriteLine("Replacement String: {0}", result)                             
   End Sub
End Module
' The example displays the following output:
'          Original String: This is   text with   far  too   much   white space.
'          Replacement String: This is text with far too much white space.

Aşağıdaki örnek, bir UNC yolundaki yerel makine ve sürücü adlarını yerel dosya yolu ile değiştirmek için yöntemini kullanır Replace(String, String, String) . Normal ifade, yerel bilgisayarın adını eklemek için özelliğini ve Environment.GetLogicalDrives mantıksal sürücülerin adlarını eklemek için yöntemini kullanırEnvironment.MachineName. Örneği başarıyla çalıştırmak için "MyMachine" değişmez dizesini yerel makine adınızla değiştirmeniz gerekir.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      // Get drives available on local computer and form into a single character expression.
      string[] drives = Environment.GetLogicalDrives();
      string driveNames = String.Empty;
      foreach (string drive in drives)
         driveNames += drive.Substring(0,1);
      // Create regular expression pattern dynamically based on local machine information.
      string pattern = @"\\\\(?i:" + Environment.MachineName + @")(?:\.\w+)*\\((?i:[" + driveNames + @"]))\$";

      string replacement = "$1:";
      string[] uncPaths = { @"\\MyMachine.domain1.mycompany.com\C$\ThingsToDo.txt", 
                            @"\\MyMachine\c$\ThingsToDo.txt", 
                            @"\\MyMachine\d$\documents\mydocument.docx" }; 
      
      foreach (string uncPath in uncPaths)
      {
         Console.WriteLine("Input string: " + uncPath);
         Console.WriteLine("Returned string: " + Regex.Replace(uncPath, pattern, replacement));
         Console.WriteLine();
      }
   }
}
// The example displays the following output if run on a machine whose name is
// MyMachine:
//    Input string: \\MyMachine.domain1.mycompany.com\C$\ThingsToTo.txt
//    Returned string: C:\ThingsToDo.txt
//    
//    Input string: \\MyMachine\c$\ThingsToDo.txt
//    Returned string: c:\ThingsToDo.txt
//    
//    Input string: \\MyMachine\d$\documents\mydocument.docx
//    Returned string: d:\documents\mydocument.docx

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      ' Get drives available on local computer and form into a single character expression.
      Dim drives() As String = Environment.GetLogicalDrives()
      Dim driveNames As String = Nothing
      For Each drive As String In drives
         driveNames += drive.Substring(0,1)
      Next
      ' Create regular expression pattern dynamically based on local machine information.
      Dim pattern As String = "\\\\(?i:" + Environment.MachineName + ")(?:\.\w+)*\\((?i:[" + driveNames + "]))\$"

      Dim replacement As String = "$1:"
      Dim uncPaths() AS String = {"\\MyMachine.domain1.mycompany.com\C$\ThingsToDo.txt", _
                                  "\\MyMachine\c$\ThingsToDo.txt", _
                                  "\\MyMachine\d$\documents\mydocument.docx" } 
      
      For Each uncPath As String In uncPaths
         Console.WriteLine("Input string: " + uncPath)
         Console.WriteLine("Returned string: " + Regex.Replace(uncPath, pattern, replacement))
         Console.WriteLine()
      Next
   End Sub
End Module
' The example displays the following output if run on a machine whose name is
' MyMachine:
'    Input string: \\MyMachine.domain1.mycompany.com\C$\ThingsToTo.txt
'    Returned string: C:\ThingsToDo.txt
'    
'    Input string: \\MyMachine\c$\ThingsToDo.txt
'    Returned string: c:\ThingsToDo.txt
'    
'    Input string: \\MyMachine\d$\documents\mydocument.docx
'    Returned string: d:\documents\mydocument.docx

Normal ifade deseni aşağıdaki ifadeyle tanımlanır:

"\\\\(?i:" + Environment.MachineName + ")(?:\.\w+)*\\((?i:[" + driveNames + "]))\$"

Aşağıdaki tabloda normal ifade deseninin nasıl yorumlandığı gösterilmektedir.

Desen	Tarif
\\\\	İki ardışık ters eğik çizgi (\) karakteri eşleştirin. Ters eğik çizgi karakteri kaçış karakteri olarak yorumlandığından, her ters eğik çizginin başka bir ters eğik çizgiyle kaçış karakteri olması gerekir.
(?i:" + Environment.MachineName + ")	özelliği tarafından döndürülen dizenin büyük/küçük harfe duyarlı olmayan eşleşmesini gerçekleştirin Environment.MachineName .
(?:\.\w+)*	Nokta (.) karakterini ve ardından bir veya daha fazla sözcük karakterini eşleştirin. Bu eşleşme sıfır veya daha fazla kez gerçekleşebilir. Eşleşen alt ifade yakalanmaz.
\\	Ters eğik çizgi (\) karakterini eşleştirin.
((?i:[" + driveNames + "]))	Tek tek sürücü harflerinden oluşan karakter sınıfının büyük/küçük harfe duyarsız eşleşmesini gerçekleştirin. Bu eşleşme, yakalanan ilk alt ifadedir.
\$	Sabit dolar işareti ($) karakterini eşleştirin.

Değiştirme düzeni $1 , eşleşmenin tamamını yakalanan ilk alt ifadeyle değiştirir. Yani, UNC makinesini ve sürücü adını sürücü harfiyle değiştirir.

Açıklamalar

Statik Replace yöntemler, belirtilen normal ifade desenine sahip bir Regex nesne oluşturmak ve örnek yöntemini çağırmakla eşdeğerdir Replace.

parametresi, pattern eşleşecek dizeyi simgesel olarak tanımlayan normal ifade dili öğelerinden oluşur. Normal ifadeler hakkında daha fazla bilgi için bkz. .NET Normal İfadeleri ve Normal İfade Dili - Hızlı Başvuru. Eşleşme araması dizenin başında input başlar.

parametresi içindeki replacement her eşleşmenin inputdeğiştirilme dizesini belirtir. replacement değişmez metin ve değiştirmelerin herhangi bir bileşiminden oluşabilir. Örneğin, değiştirme deseni a*${test}b "a*" dizesini ve ardından yakalama grubuyla test eşleşen alt dizeyi (varsa) ve ardından "b" dizesini ekler. * karakteri, değiştirme deseni içinde meta karakter olarak tanınmaz.

Not

Değiştirmeler, değiştirme deseninde tanınan tek normal ifade dili öğeleridir. Karakter kaçışları da dahil olmak üzere diğer tüm normal ifade dili öğelerine yalnızca normal ifade desenlerinde izin verilir ve değiştirme desenlerinde tanınmaz.

Değiştirme RegexMatchTimeoutException işleminin yürütme süresi yöntemin çağrıldığı uygulama etki alanı için belirtilen zaman aşımı aralığını aşarsa özel durum oluşturulur. Uygulama etki alanının özelliklerinde zaman aşımı tanımlanmamışsa veya zaman aşımı değeri ise Regex.InfiniteMatchTimeoutözel durum oluşturmaz.

Eşleşme yoksa yöntemi değişmeden döndürdüğünden input , yöntemini kullanarak yöntemin Object.ReferenceEquals giriş dizesinde herhangi bir değişiklik yapıp yapmadığını belirleyebilirsiniz.

Arayanlara Notlar

Bu yöntem, çağrıldığı uygulama etki alanının varsayılan zaman aşımı değerine eşit bir aralıktan sonra zaman aşımına uğradı. Uygulama etki alanı için zaman aşımı değeri tanımlanmamışsa, yönteminin zaman aşımına girmesini engelleyen değeri InfiniteMatchTimeoutkullanılır. Bir desen eşleşmesini değiştirmek için önerilen statik yöntem, zaman aşımı aralığını ayarlamanıza olanak tanıyan yöntemidir Replace(String, String, String, RegexOptions, TimeSpan).

Ayrıca bkz.

• Normal İfadelerdeki Değişimler
• Normal İfade Dili Öğeleri

Replace(String, String, MatchEvaluator)

Kaynak:

Regex.Replace.cs

Belirtilen giriş dizesinde, belirtilen normal ifadeyle eşleşen tüm dizeleri bir MatchEvaluator temsilci tarafından döndürülen bir dizeyle değiştirir.

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

Parametreler

input

String

Eşleşme aranacak dize.

pattern

String

Eşleşecek normal ifade deseni.

evaluator

MatchEvaluator

Her eşleşmeyi inceleyen ve özgün eşleşen dizeyi veya değiştirme dizesini döndüren özel bir yöntem.

Döndürülenler

String

Eşleşen her dizenin yerini bir değiştirme dizesinin alması dışında giriş dizesiyle aynı olan yeni bir dize. Geçerli örnekte eşleşmezse pattern , yöntemi geçerli örneği değişmeden döndürür.

Özel durumlar

ArgumentException

Normal ifade ayrıştırma hatası oluştu.

ArgumentNullException

input, patternveya evaluator şeklindedir null.

RegexMatchTimeoutException

Zaman aşımı oluştu. Zaman aşımları hakkında daha fazla bilgi için Açıklamalar bölümüne bakın.

Örnekler

Aşağıdaki örnek, bir dizedeki tek tek sözcükleri ayıklamak için normal bir ifade kullanır ve ardından bir temsilci kullanarak MatchEvaluator sözcükteki tek tek harfleri karıştıran adlı WordScramble bir yöntemi çağırır. Bunu yapmak için yöntemi, WordScramble eşleşmedeki karakterleri içeren bir dizi oluşturur. Ayrıca rastgele kayan nokta sayılarıyla dolduran paralel bir dizi oluşturur. Diziler yöntemi çağrılarak Array.Sort<TKey,TValue>(TKey[], TValue[], IComparer<TKey>) sıralanır ve sıralanan dizi bir String sınıf oluşturucusunun bağımsız değişkeni olarak sağlanır. Bu yeni oluşturulan dize daha sonra yöntemi tarafından WordScramble döndürülür. Normal ifade deseni \w+ bir veya daha fazla sözcük karakteriyle eşleşir; normal ifade altyapısı, boşluk karakteri gibi sözcük olmayan bir karakterle karşılaşana kadar eşleşmeye karakter eklemeye devam eder.

using System;
using System.Collections;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string words = "letter alphabetical missing lack release " + 
                     "penchant slack acryllic laundry cease";
      string pattern = @"\w+";                            
      MatchEvaluator evaluator = new MatchEvaluator(WordScrambler);
      Console.WriteLine("Original words:");
      Console.WriteLine(words);
      Console.WriteLine();
      Console.WriteLine("Scrambled words:");
      Console.WriteLine(Regex.Replace(words, pattern, evaluator));      
   }

   public static string WordScrambler(Match match)
   {
      int arraySize = match.Value.Length;
      // Define two arrays equal to the number of letters in the match.
      double[] keys = new double[arraySize];
      char[] letters = new char[arraySize];
      
      // Instantiate random number generator'
      Random rnd = new Random();
      
      for (int ctr = 0; ctr < match.Value.Length; ctr++)
      {
         // Populate the array of keys with random numbers.
         keys[ctr] = rnd.NextDouble();
         // Assign letter to array of letters.
         letters[ctr] = match.Value[ctr];
      }         
      Array.Sort(keys, letters, 0, arraySize, Comparer.Default);      
      return new String(letters);
   }
}
// The example displays output similar to the following:
//    Original words:
//    letter alphabetical missing lack release penchant slack acryllic laundry cease
//    
//    Scrambled words:
//    elrtte iaeabatlpchl igmnssi lcka aerslee hnpatnce ksacl lialcryc dylruna ecase

Imports System.Collections
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim words As String = "letter alphabetical missing lack release " + _
                            "penchant slack acryllic laundry cease"
      Dim pattern As String = "\w+"                            
      Dim evaluator As MatchEvaluator = AddressOf WordScrambler
      Console.WriteLine("Original words:")
      Console.WriteLine(words)
      Console.WriteLine("Scrambled words:")
      Console.WriteLine(Regex.Replace(words, pattern, evaluator))      
   End Sub
   
   Public Function WordScrambler(match As Match) As String
      Dim arraySize As Integer = match.Value.Length - 1
      ' Define two arrays equal to the number of letters in the match.
      Dim keys(arraySize) As Double
      Dim letters(arraySize) As Char
      
      ' Instantiate random number generator'
      Dim rnd As New Random()
      
      For ctr As Integer = 0 To match.Value.Length - 1
         ' Populate the array of keys with random numbers.
         keys(ctr) = rnd.NextDouble()
         ' Assign letter to array of letters.
         letters(ctr) = match.Value.Chars(ctr)
      Next         
      Array.Sort(keys, letters, 0, arraySize, Comparer.Default)      
      Return New String(letters)
   End Function
End Module
' The example displays output similar to the following:
'    Original words:
'    letter alphabetical missing lack release penchant slack acryllic laundry cease
'    
'    Scrambled words:
'    elrtte iaeabatlpchl igmnssi lcka aerslee hnpatnce ksacl lialcryc dylruna ecase

Açıklamalar

yöntemi, Regex.Replace(String, String, MatchEvaluator) aşağıdaki koşullardan biri doğruysa normal ifade eşleşmesini değiştirmek için kullanışlıdır:

• Değiştirme dizesi, normal ifade değiştirme deseni tarafından hazır olarak belirtilemez.

• Değiştirme dizesi, eşleşen dizede yapılan bazı işlemlerden kaynaklanır.

• Değiştirme dizesi koşullu işleme sonucu verir.

yöntemi, yöntemini çağırmak Regex.Matches(String, String) ve döndürülen MatchCollection koleksiyondaki her Match nesneyi temsilciye geçirmekle evaluator eşdeğerdir.

parametresi, pattern eşleşecek dizeyi simgesel olarak tanımlayan normal ifade dili öğelerinden oluşur. Normal ifadeler hakkında daha fazla bilgi için bkz. .NET Normal İfadeleri ve Normal İfade Dili - Hızlı Başvuru.

evaluator parametresi, tanımladığınız ve her eşleşmeyi inceleyen özel bir yöntemin temsilcisidir. Özel yöntemin temsilciyle eşleşmesi için aşağıdaki imzaya MatchEvaluator sahip olması gerekir.

public string MatchEvaluatorMethod(Match match)

Public Function MatchEvaluatorMethod(match As Match) As String

Özel yönteminiz, eşleşen girişin yerini alan bir dize döndürür.

Değiştirme RegexMatchTimeoutException işleminin yürütme süresi yöntemin çağrıldığı uygulama etki alanı için belirtilen zaman aşımı aralığını aşarsa özel durum oluşturulur. Uygulama etki alanının özelliklerinde zaman aşımı tanımlanmamışsa veya zaman aşımı değeri ise Regex.InfiniteMatchTimeoutözel durum oluşturmaz.

Eşleşme yoksa yöntemi değişmeden döndürdüğünden input , yöntemini kullanarak yöntemin Object.ReferenceEquals giriş dizesinde herhangi bir değişiklik yapıp yapmadığını belirleyebilirsiniz.

Arayanlara Notlar

Bu yöntem, çağrıldığı uygulama etki alanının varsayılan zaman aşımı değerine eşit bir aralıktan sonra zaman aşımına uğradı. Uygulama etki alanı için zaman aşımı değeri tanımlanmamışsa, yönteminin zaman aşımına girmesini engelleyen değeri InfiniteMatchTimeoutkullanılır. Desen eşleşmesini değerlendirmek ve değiştirmek için önerilen statik yöntem, zaman aşımı aralığını ayarlamanıza olanak tanıyan yöntemidir Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan).

Ayrıca bkz.

• MatchEvaluator
• Normal İfadelerdeki Değişimler
• Normal İfade Dili Öğeleri

Replace(String, String, Int32)

Kaynak:

Regex.Replace.cs

Belirtilen bir giriş dizesinde, normal ifade deseniyle eşleşen belirtilen en fazla sayıda dizeyi belirtilen bir değiştirme dizesiyle değiştirir.

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

Parametreler

input

String

Eşleşme aranacak dize.

replacement

String

Değiştirme dizesi.

count

Int32

Değiştirmenin en fazla kaç kez gerçekleşebileceği.

Döndürülenler

String

Değiştirilen dizenin eşleşen her dizenin yerini alması dışında giriş dizesiyle aynı olan yeni bir dize. Normal ifade deseni geçerli örnekte eşleşmiyorsa, yöntemi geçerli örneği değişmeden döndürür.

Özel durumlar

ArgumentNullException

input veya replacement şeklindedir null.

RegexMatchTimeoutException

Zaman aşımı oluştu. Zaman aşımları hakkında daha fazla bilgi için Açıklamalar bölümüne bakın.

Örnekler

Aşağıdaki örnek, yinelenen karakterlerin ilk beş oluşumunu tek bir karakterle değiştirir. Normal ifade düzeni (\w)\1 , tek bir karakterin ardışık oluşumlarıyla eşleşir ve ilk oluşumu ilk yakalama grubuna atar. Değiştirme düzeni $1 , eşleşmenin tamamını yakalanan ilk grupla değiştirir.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string str = "aabccdeefgghiijkklmm";
      string pattern = "(\\w)\\1"; 
      string replacement = "$1"; 
      Regex rgx = new Regex(pattern);

      string result = rgx.Replace(str, replacement, 5);
      Console.WriteLine("Original String:    '{0}'", str);
      Console.WriteLine("Replacement String: '{0}'", result); 
   }
}
// The example displays the following output:
//       Original String:    'aabccdeefgghiijkklmm'
//       Replacement String: 'abcdefghijkklmm'

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim str As String = "aabccdeefgghiijkklmm"
      Dim pattern As String = "(\w)\1" 
      Dim replacement As String = "$1" 
      Dim rgx As New Regex(pattern)

      Dim result As String = rgx.Replace(str, replacement, 5)
      Console.WriteLine("Original String:    '{0}'", str)
      Console.WriteLine("Replacement String: '{0}'", result)                             
   End Sub
End Module
' The example displays the following output:
'       Original String:    'aabccdeefgghiijkklmm'
'       Replacement String: 'abcdefghijkklmm'

Açıklamalar

Eşleşme araması dizenin başında input başlar. Normal ifade, geçerli Regex nesnenin oluşturucu tarafından tanımlanan desendir. Negatifse count , değiştirmeler dizenin sonuna kadar devam eder. Eşleşme sayısını aşarsa count , tüm eşleşmeler değiştirilir.

parametresi, replacement içindeki inputilk count eşleşmelerin yerini alacak dizeyi belirtir. replacement değişmez metin ve değiştirmelerin herhangi bir bileşiminden oluşabilir. Örneğin, değiştirme deseni a*${test}b "a*" dizesini ve ardından yakalama grubuyla test eşleşen alt dizeyi (varsa) ve ardından "b" dizesini ekler. * karakteri, değiştirme deseni içinde meta karakter olarak tanınmaz.

Not

Değiştirmeler, değiştirme deseninde tanınan tek normal ifade dili öğeleridir. Karakter kaçışları da dahil olmak üzere diğer tüm normal ifade dili öğelerine yalnızca normal ifade desenlerinde izin verilir ve değiştirme desenlerinde tanınmaz.

RegexMatchTimeoutException Değiştirme işleminin yürütme süresi oluşturucu tarafından Regex.Regex(String, RegexOptions, TimeSpan) belirtilen zaman aşımı aralığını aşarsa özel durum oluşturulur. Oluşturucuyu çağırdığınızda zaman aşımı aralığı ayarlamazsanız, işlem Regex nesnesinin oluşturulduğu uygulama etki alanı için belirlenen zaman aşımı değerini aşarsa özel durum oluşturulur. Oluşturucu çağrısında veya uygulama etki alanının özelliklerinde Regex zaman aşımı tanımlanmadıysa ya da zaman aşımı değeri ise Regex.InfiniteMatchTimeoutözel durum oluşturmaz

Eşleşme yoksa yöntemi değişmeden döndürdüğünden input , yöntemini kullanarak yöntemin Object.ReferenceEquals giriş dizesinde herhangi bir değişiklik yapıp yapmadığını belirleyebilirsiniz.

Ayrıca bkz.

• Düzenli İfade Dili - Hızlı Referans
• Normal İfadelerdeki Değişimler

Replace(String, MatchEvaluator)

Kaynak:

Regex.Replace.cs

Belirtilen giriş dizesinde, belirtilen normal ifadeyle eşleşen tüm dizeleri bir MatchEvaluator temsilci tarafından döndürülen bir dizeyle değiştirir.

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

Parametreler

input

String

Eşleşme aranacak dize.

evaluator

MatchEvaluator

Her eşleşmeyi inceleyen ve özgün eşleşen dizeyi veya değiştirme dizesini döndüren özel bir yöntem.

Döndürülenler

String

Eşleşen her dizenin yerini bir değiştirme dizesinin alması dışında giriş dizesiyle aynı olan yeni bir dize. Normal ifade deseni geçerli örnekte eşleşmiyorsa, yöntemi geçerli örneği değişmeden döndürür.

Özel durumlar

ArgumentNullException

input veya evaluator şeklindedir null.

RegexMatchTimeoutException

Zaman aşımı oluştu. Zaman aşımları hakkında daha fazla bilgi için Açıklamalar bölümüne bakın.

Örnekler

Aşağıdaki kod örneği özgün dizeyi görüntüler, özgün dizedeki her sözcükle eşleşir, her eşleşmenin ilk karakterini büyük harfe dönüştürür ve sonra dönüştürülen dizeyi görüntüler.

using System;
using System.Text.RegularExpressions;

class RegExSample
{
    static string CapText(Match m)
    {
        // Get the matched string.
        string x = m.ToString();
        // If the first char is lower case...
        if (char.IsLower(x[0]))
        {
            // Capitalize it.
            return char.ToUpper(x[0]) + x.Substring(1, x.Length - 1);
        }
        return x;
    }

    static void Main()
    {
        string text = "four score and seven years ago";

        Console.WriteLine($"text=[{text}]");

        Regex rx = new Regex(@"\w+");

        string result = rx.Replace(text, new MatchEvaluator(RegExSample.CapText));

        Console.WriteLine($"result=[{result}]");
    }
}
// The example displays the following output:
//       text=[four score and seven years ago]
//       result=[Four Score And Seven Years Ago]

Imports System.Text.RegularExpressions

Module RegExSample
    Function CapText(ByVal m As Match) As String
        ' Get the matched string.
        Dim x As String = m.ToString()
        ' If the first char is lower case...
        If Char.IsLower(x.Chars(0)) Then
            ' Capitalize it.
            Return Char.ToUpper(x.Chars(0)) & x.Substring(1, x.Length - 1)
        End If
        Return x
    End Function

    Sub Main()
        Dim text As String = "four score and seven years ago"

        Console.WriteLine($"text=[{text}]")

        Dim rx As New Regex("\w+")

        Dim result As String = rx.Replace(text, AddressOf RegExSample.CapText)

        Console.WriteLine($"result=[{result}]")
    End Sub
End Module
' The example displays the following output:
'       text=[four score and seven years ago]
'       result=[Four Score And Seven Years Ago]

Açıklamalar

yöntemi, Regex.Replace(String, MatchEvaluator) aşağıdaki koşullardan biri doğruysa normal ifade eşleşmesini değiştirmek için kullanışlıdır:

• Değiştirme dizesi, normal ifade değiştirme deseni tarafından hazır olarak belirtilemez.

• Değiştirme dizesi, eşleşen dizede yapılan bazı işlemlerden kaynaklanır.

• Değiştirme dizesi koşullu işleme sonucu verir.

yöntemi, yöntemini çağırmak Regex.Matches(String) ve döndürülen MatchCollection koleksiyondaki her Match nesneyi temsilciye geçirmekle evaluator eşdeğerdir.

Normal ifade, geçerli Regex nesne için oluşturucu tarafından tanımlanan desendir.

evaluator parametresi, tanımladığınız ve her eşleşmeyi inceleyen özel bir yöntemin temsilcisidir. Özel yöntemin temsilciyle eşleşmesi için aşağıdaki imzaya MatchEvaluator sahip olması gerekir.

public string MatchEvaluatorMethod(Match match)

Public Function MatchEvaluatorMethod(match As Match) As String

Özel yönteminiz, eşleşen girişin yerini alan bir dize döndürür.

RegexMatchTimeoutException Değiştirme işleminin yürütme süresi oluşturucu tarafından Regex.Regex(String, RegexOptions, TimeSpan) belirtilen zaman aşımı aralığını aşarsa özel durum oluşturulur. Oluşturucuyu çağırdığınızda zaman aşımı aralığı ayarlamazsanız, işlem Regex nesnesinin oluşturulduğu uygulama etki alanı için belirlenen zaman aşımı değerini aşarsa özel durum oluşturulur. Oluşturucu çağrısında veya uygulama etki alanının özelliklerinde Regex zaman aşımı tanımlanmadıysa ya da zaman aşımı değeri ise Regex.InfiniteMatchTimeoutözel durum oluşturmaz

Eşleşme yoksa yöntemi değişmeden döndürdüğünden input , yöntemini kullanarak yöntemin Object.ReferenceEquals giriş dizesinde herhangi bir değişiklik yapıp yapmadığını belirleyebilirsiniz.

Ayrıca bkz.

• MatchEvaluator
• Normal İfadelerdeki Değişimler
• Düzenli İfade Dili - Hızlı Referans

Replace(String, String)

Kaynak:

Regex.Replace.cs

Belirtilen bir giriş dizesinde, normal ifade deseniyle eşleşen tüm dizeleri belirtilen bir değiştirme dizesiyle değiştirir.

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

Parametreler

input

String

Eşleşme aranacak dize.

replacement

String

Değiştirme dizesi.

Döndürülenler

String

Değiştirilen dizenin eşleşen her dizenin yerini alması dışında giriş dizesiyle aynı olan yeni bir dize. Normal ifade deseni geçerli örnekte eşleşmiyorsa, yöntemi geçerli örneği değişmeden döndürür.

Özel durumlar

ArgumentNullException

input veya replacement şeklindedir null.

RegexMatchTimeoutException

Zaman aşımı oluştu. Zaman aşımları hakkında daha fazla bilgi için Açıklamalar bölümüne bakın.

Örnekler

Aşağıdaki örnek, \s+bir veya daha fazla boşluk karakteriyle eşleşen normal ifadeyi tanımlar. " " yerine geçen dize, bunları tek bir boşluk karakteriyle değiştirir.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = "This is   text with   far  too   much   " + 
                     "white space.";
      string pattern = "\\s+";
      string replacement = " ";
      Regex rgx = new Regex(pattern);
      string result = rgx.Replace(input, replacement);
      
      Console.WriteLine("Original String: {0}", input);
      Console.WriteLine("Replacement String: {0}", result);                             
   }
}
// The example displays the following output:
//       Original String: This is   text with   far  too   much   white space.
//       Replacement String: This is text with far too much white space.

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "This is   text with   far  too   much   " + _
                            "white space."
      Dim pattern As String = "\s+"
      Dim replacement As String = " "
      Dim rgx As New Regex(pattern)
      Dim result As String = rgx.Replace(input, replacement)
      
      Console.WriteLine("Original String: {0}", input)
      Console.WriteLine("Replacement String: {0}", result)                             
   End Sub
End Module
' The example displays the following output:
'          Original String: This is   text with   far  too   much   white space.
'          Replacement String: This is text with far too much white space.

Aşağıdaki örnek, (\p{Sc}\s?)?(\d+\.?((?<=\.)\d+)?)(?(1)|\s?\p{Sc})?bir sayısal değerden baştaki veya sondaki para birimi simgesini kaldıran bir normal ifade, ve bir değiştirme deseni $2tanımlar.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern =  @"(\p{Sc}\s?)?(\d+\.?((?<=\.)\d+)?)(?(1)|\s?\p{Sc})?";
      string input = "$17.43  €2 16.33  £0.98  0.43   £43   12€  17";
      string replacement = "$2";
      Regex rgx = new Regex(pattern);
      string result = rgx.Replace(input, replacement);

      Console.WriteLine("Original String:    '{0}'", input);
      Console.WriteLine("Replacement String: '{0}'", result);                             
   }
}
// The example displays the following output:
//       Original String:    '$17.43  €2 16.33  £0.98  0.43   £43   12€  17'
//       Replacement String: '17.43  2 16.33  0.98  0.43   43   12  17'

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String =  "(\p{Sc}\s?)?(\d+\.?((?<=\.)\d+)?)(?(1)|\s?\p{Sc})?"
      Dim input As String = "$17.43  €2 16.33  £0.98  0.43   £43   12€  17"
      Dim replacement As String = "$2"
      Dim rgx As New Regex(pattern)
      Dim result As String = rgx.Replace(input, replacement)

      Console.WriteLine("Original String:    '{0}'", input)
      Console.WriteLine("Replacement String: '{0}'", result)                             
   End Sub
End Module
' The example displays the following output:
'       Original String:    '$17.43  €2 16.33  £0.98  0.43   £43   12€  17'
'       Replacement String: '17.43  2 16.33  0.98  0.43   43   12  17'

Normal ifade aşağıdaki tabloda gösterildiği gibi yorumlanır.

Desen	Tarif
\p{Sc}	Para birimi simgesiyle eşleş. {Sc} Unicode Simgesi, Para Birimi kategorisinin üyesi olan herhangi bir karakteri belirtir.
\s?	Sıfır veya bir boşluk karakteriyle eşleş.
(\p{Sc}\s?)?	Para birimi simgesinin ve ardından sıfır veya bir boşluk karakteri gelen birleşiminin sıfır veya bir oluşumunu eşleştirin. Bu, ilk yakalama grubudur.
\d+	Bir veya daha fazla ondalık basamağı eşleştirin.
\.?	Noktanın sıfırını veya bir oluşumunu eşleştirin (ondalık ayırıcı karakter olarak kullanılır).
((?<=\.)\d+)?	Nokta önceki karakterse, bir veya daha fazla ondalık basamak eşleştirin. Bu desen sıfır veya bir kez eşleştirilebilir.
(\d+\.?((?<=\.)\d+)?)	Bir veya daha fazla ondalık basamağı ve ardından isteğe bağlı bir nokta ve ek ondalık basamak desenini eşleştirin. Bu ikinci yakalama grubudur. yöntemine yapılan Replace(String, String) çağrı, eşleşmenin tamamını bu yakalanan grubun değeriyle değiştirir.
(?(1)|\s?\p{Sc})?	yakalanan ilk grup varsa, boş bir dizeyle eşleştirin. Aksi takdirde, sıfır veya bir boşluk karakterini ve ardından bir para birimi simgesini eşleştirin.

Açıklamalar

Eşleşme araması dizenin başında input başlar. Normal ifade, geçerli Regex nesne için oluşturucu tarafından tanımlanan desendir.

parametresi içindeki replacement her eşleşmenin inputdeğiştirilme dizesini belirtir. replacement değişmez metin ve değiştirmelerin herhangi bir bileşiminden oluşabilir. Örneğin, değiştirme deseni a*${test}b "a*" dizesini ve ardından yakalama grubuyla test eşleşen alt dizeyi (varsa) ve ardından "b" dizesini ekler. * karakteri, değiştirme deseni içinde meta karakter olarak tanınmaz.

Not

Değiştirmeler, değiştirme deseninde tanınan tek normal ifade dili öğeleridir. Karakter kaçışları da dahil olmak üzere diğer tüm normal ifade dili öğelerine yalnızca normal ifade desenlerinde izin verilir ve değiştirme desenlerinde tanınmaz.

RegexMatchTimeoutException Değiştirme işleminin yürütme süresi oluşturucu tarafından Regex.Regex(String, RegexOptions, TimeSpan) belirtilen zaman aşımı aralığını aşarsa özel durum oluşturulur. Oluşturucuyu çağırdığınızda zaman aşımı aralığı ayarlamazsanız, işlem Regex nesnesinin oluşturulduğu uygulama etki alanı için belirlenen zaman aşımı değerini aşarsa özel durum oluşturulur. Oluşturucu çağrısında veya uygulama etki alanının özelliklerinde Regex zaman aşımı tanımlanmadıysa ya da zaman aşımı değeri ise Regex.InfiniteMatchTimeoutözel durum oluşturmaz

Eşleşme yoksa yöntemi değişmeden döndürdüğünden input , yöntemini kullanarak yöntemin Object.ReferenceEquals giriş dizesinde herhangi bir değişiklik yapıp yapmadığını belirleyebilirsiniz.

Ayrıca bkz.

• Düzenli İfade Dili - Hızlı Referans
• Normal İfadelerdeki Değişimler

Replace(String, MatchEvaluator, Int32)

Kaynak:

Regex.Replace.cs

Belirtilen giriş dizesinde, normal ifade deseniyle eşleşen belirtilen en fazla sayıda dizeyi bir temsilci tarafından MatchEvaluator döndürülen bir dizeyle değiştirir.

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

Parametreler

input

String

Eşleşme aranacak dize.

evaluator

MatchEvaluator

Her eşleşmeyi inceleyen ve özgün eşleşen dizeyi veya değiştirme dizesini döndüren özel bir yöntem.

count

Int32

Değiştirmenin en fazla kaç kez gerçekleşeceği.

Döndürülenler

String

Eşleşen her dizenin yerini bir değiştirme dizesinin alması dışında giriş dizesiyle aynı olan yeni bir dize. Normal ifade deseni geçerli örnekte eşleşmiyorsa, yöntemi geçerli örneği değişmeden döndürür.

Özel durumlar

ArgumentNullException

input veya evaluator şeklindedir null.

RegexMatchTimeoutException

Zaman aşımı oluştu. Zaman aşımları hakkında daha fazla bilgi için Açıklamalar bölümüne bakın.

Örnekler

Aşağıdaki örnek, listedeki sözcüklerin yarısını bilerek yanlış göndermek için normal bir ifade kullanır. "ee" veya "ei" karakterlerini içeren sözcükleri eşleştirmek için normal ifadeyi \w*(ie|ei)\w* kullanır. Eşleşen sözcüklerin ilk yarısını yöntemine ReverseLetter geçirir ve bu da eşleşen dizede "i" ve "e" değerlerini ters çevirmek için yöntemini kullanır Replace(String, String, String, RegexOptions) . Kalan sözcükler değişmeden kalır.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = "deceive relieve achieve belief fierce receive";
      string pattern = @"\w*(ie|ei)\w*";
      Regex rgx = new Regex(pattern, RegexOptions.IgnoreCase);
      Console.WriteLine("Original string: " + input);
      
      string result = rgx.Replace(input, new MatchEvaluator(Example.ReverseLetter), 
                                  input.Split(' ').Length / 2);
      Console.WriteLine("Returned string: " + result);
   }

   static string ReverseLetter(Match match)
   {
      return Regex.Replace(match.Value, "([ie])([ie])", "$2$1", 
                           RegexOptions.IgnoreCase);            
   }
}
// The example displays the following output:
//    Original string: deceive relieve achieve belief fierce receive
//    Returned string: decieve releive acheive belief fierce receive

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "deceive relieve achieve belief fierce receive"
      Dim pattern As String = "\w*(ie|ei)\w*"
      Dim rgx As New Regex(pattern, RegexOptions.IgnoreCase)
      Console.WriteLine("Original string: " + input)
      
      Dim result As String = rgx.Replace(input, AddressOf ReverseLetter, 
                                           input.Split(" "c).Length \ 2)
      Console.WriteLine("Returned string: " + result)
   End Sub

   Public Function ReverseLetter(match As Match) As String
      Return Regex.Replace(match.Value, "([ie])([ie])", "$2$1", 
                           RegexOptions.IgnoreCase)            
   End Function
End Module
' The example displays the following output:
'    Original string: deceive relieve achieve belief fierce receive
'    Returned string: decieve releive acheive belief fierce receive

Normal ifade \w*(ie|ei)\w* aşağıdaki tabloda gösterildiği gibi tanımlanır.

Desen	Tarif
\w*	Sıfır veya daha fazla sözcük karakteri eşleştirin.
(ie|ei)	"ie" veya "ei" ile eşleştirin.
\w*	Sıfır veya daha fazla sözcük karakteri eşleştirin.

Yöntemdeki ReverseLetter normal ifade deseni([ie])([ie]), diphthong "ie" veya "ei" içindeki ilk "i" veya "e" ile eşleşir ve harfi ilk yakalama grubuna atar. İkinci "i" veya "e" ile eşleşir ve harfi ikinci yakalama grubuna atar. Ardından iki karakter, değiştirme deseni Replace(String, String, String)$2$1ile yöntemi çağrılarak tersine çevrilir.

Açıklamalar

yöntemi, Regex.Replace(String, MatchEvaluator, Int32) aşağıdaki koşullardan biri doğruysa normal ifade eşleşmesini değiştirmek için kullanışlıdır:

• Değiştirme dizesi, normal ifade değiştirme deseni tarafından hazır olarak belirtilemez.

• Değiştirme dizesi, eşleşen dizede yapılan bazı işlemlerden kaynaklanır.

• Değiştirme dizesi koşullu işleme sonucu verir.

yöntemi, yöntemini çağırmak Regex.Matches(String) ve döndürülen MatchCollection koleksiyondaki ilk countMatch nesneleri temsilciye geçirmekle evaluator eşdeğerdir.

Normal ifade, geçerli Regex nesne için oluşturucu tarafından tanımlanan desendir.

evaluator parametresi, tanımladığınız ve her eşleşmeyi inceleyen özel bir yöntemin temsilcisidir. Özel yöntemin temsilciyle eşleşmesi için aşağıdaki imzaya MatchEvaluator sahip olması gerekir.

public string MatchEvaluatorMethod(Match match)

Public Function MatchEvaluatorMethod(match As Match) As String

Özel yönteminiz, eşleşen girişin yerini alan bir dize döndürür.

RegexMatchTimeoutException Değiştirme işleminin yürütme süresi oluşturucu tarafından Regex.Regex(String, RegexOptions, TimeSpan) belirtilen zaman aşımı aralığını aşarsa özel durum oluşturulur. Oluşturucuyu çağırdığınızda zaman aşımı aralığı ayarlamazsanız, işlem Regex nesnesinin oluşturulduğu uygulama etki alanı için belirlenen zaman aşımı değerini aşarsa özel durum oluşturulur. Oluşturucu çağrısında veya uygulama etki alanının özelliklerinde Regex zaman aşımı tanımlanmadıysa ya da zaman aşımı değeri ise Regex.InfiniteMatchTimeoutözel durum oluşturmaz

Eşleşme yoksa yöntemi değişmeden döndürdüğünden input , yöntemini kullanarak yöntemin Object.ReferenceEquals giriş dizesinde herhangi bir değişiklik yapıp yapmadığını belirleyebilirsiniz.

Ayrıca bkz.

• MatchEvaluator
• Normal İfadelerdeki Değişimler
• Düzenli İfade Dili - Hızlı Referans