Regex.Replace Methode

Definitie

In een opgegeven invoertekenreeks vervangt u tekenreeksen die overeenkomen met een normaal expressiepatroon door een opgegeven vervangende tekenreeks.

Overloads

Name Description
Replace(String, String, String, RegexOptions)

In een opgegeven invoertekenreeks vervangt u alle tekenreeksen die overeenkomen met een opgegeven reguliere expressie met een opgegeven vervangende tekenreeks. Opgegeven opties wijzigen de overeenkomende bewerking.

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

In een opgegeven invoertekenreeks vervangt u alle tekenreeksen die overeenkomen met een opgegeven reguliere expressie met een opgegeven vervangende tekenreeks. Aanvullende parameters geven opties op waarmee de overeenkomende bewerking en een time-outinterval worden gewijzigd als er geen overeenkomst wordt gevonden.

Replace(String, MatchEvaluator, Int32, Int32)

In een opgegeven invoersubtekenreeks vervangt u een opgegeven maximum aantal tekenreeksen dat overeenkomt met een normaal expressiepatroon door een tekenreeks die wordt geretourneerd door een MatchEvaluator gemachtigde.

Replace(String, String, MatchEvaluator, RegexOptions)

In een opgegeven invoertekenreeks vervangt u alle tekenreeksen die overeenkomen met een opgegeven reguliere expressie door een tekenreeks die wordt geretourneerd door een MatchEvaluator gemachtigde. Opgegeven opties wijzigen de overeenkomende bewerking.

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

In een opgegeven invoertekenreeks vervangt u alle subtekenreeksen die overeenkomen met een opgegeven reguliere expressie door een tekenreeks die wordt geretourneerd door een MatchEvaluator gemachtigde. Aanvullende parameters geven opties op waarmee de overeenkomende bewerking en een time-outinterval worden gewijzigd als er geen overeenkomst wordt gevonden.

Replace(String, String, Int32, Int32)

In een opgegeven invoersubtekenreeks vervangt u een opgegeven maximum aantal tekenreeksen dat overeenkomt met een normaal expressiepatroon met een opgegeven vervangende tekenreeks.

Replace(String, String, String)

In een opgegeven invoertekenreeks vervangt u alle tekenreeksen die overeenkomen met een opgegeven reguliere expressiepatroon door een opgegeven vervangende tekenreeks.

Replace(String, String, MatchEvaluator)

In een opgegeven invoertekenreeks vervangt u alle tekenreeksen die overeenkomen met een opgegeven reguliere expressie door een tekenreeks die wordt geretourneerd door een MatchEvaluator gemachtigde.

Replace(String, String, Int32)

In een opgegeven invoertekenreeks vervangt u een opgegeven maximum aantal tekenreeksen dat overeenkomt met een normaal expressiepatroon met een opgegeven vervangende tekenreeks.

Replace(String, MatchEvaluator)

In een opgegeven invoertekenreeks vervangt u alle tekenreeksen die overeenkomen met een opgegeven reguliere expressie door een tekenreeks die wordt geretourneerd door een MatchEvaluator gemachtigde.

Replace(String, String)

In een opgegeven invoertekenreeks vervangt u alle tekenreeksen die overeenkomen met een normaal expressiepatroon met een opgegeven vervangende tekenreeks.

Replace(String, MatchEvaluator, Int32)

In een opgegeven invoertekenreeks vervangt u een opgegeven maximum aantal tekenreeksen dat overeenkomt met een normaal expressiepatroon door een tekenreeks die wordt geretourneerd door een MatchEvaluator gemachtigde.

Replace(String, String, String, RegexOptions)

Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs

In een opgegeven invoertekenreeks vervangt u alle tekenreeksen die overeenkomen met een opgegeven reguliere expressie met een opgegeven vervangende tekenreeks. Opgegeven opties wijzigen de overeenkomende bewerking.

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

Parameters

input
String

De tekenreeks om naar een overeenkomst te zoeken.

pattern
String

Het reguliere expressiepatroon dat moet overeenkomen.

replacement
String

De vervangende tekenreeks.

options
RegexOptions

Een bitsgewijze combinatie van de opsommingswaarden die opties bieden voor overeenkomende waarden.

Retouren

Een nieuwe tekenreeks die identiek is aan de invoertekenreeks, behalve dat de vervangende tekenreeks de plaats krijgt van elke overeenkomende tekenreeks. Als pattern deze niet overeenkomt in het huidige exemplaar, retourneert de methode het huidige exemplaar ongewijzigd.

Uitzonderingen

Er is een reguliere expressieparseringsfout opgetreden.

input, patternof replacement is null.

options is geen geldige bitsgewijze combinatie van RegexOptions waarden.

Er is een time-out opgetreden.

Opmerkingen

De statische Replace(String, String, String, RegexOptions) methoden zijn gelijk aan het maken van een Regex object met het opgegeven reguliere expressiepatroon en het aanroepen van de instantiemethode Replace(String, String).

De replacement parameter geeft de tekenreeks op die elke overeenkomst vervangt in input. replacement kan bestaan uit een combinatie van letterlijke tekst en vervangingen. Vervangingen zijn de enige reguliere expressietaalelementen die worden herkend in een vervangend patroon.

Omdat de methode ongewijzigd wordt geretourneerd input als er geen overeenkomst is, kunt u de ReferenceEquals(Object, Object) methode gebruiken om te bepalen of de methode vervangingen heeft aangebracht.

Als u opgeeft RightToLeft voor de options parameter, begint de zoekopdracht naar overeenkomsten aan het einde van de invoertekenreeks en gaat deze naar links. Anders begint de zoekopdracht aan het begin van de invoertekenreeks en gaat deze naar rechts.

Notities voor bellers

Deze methode treedt op na een interval dat gelijk is aan de standaardtime-outwaarde van het toepassingsdomein waarin deze wordt aangeroepen. Als er geen time-outwaarde is gedefinieerd voor het toepassingsdomein, wordt de waarde InfiniteMatchTimeout, waardoor er geen time-out optreedt voor de methode, gebruikt. De aanbevolen statische methode voor het vervangen van een patroonovereenkomst is Replace(String, String, String, RegexOptions, TimeSpan), waarmee u het time-outinterval kunt instellen.

Zie ook

Van toepassing op

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

Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs

In een opgegeven invoertekenreeks vervangt u alle tekenreeksen die overeenkomen met een opgegeven reguliere expressie met een opgegeven vervangende tekenreeks. Aanvullende parameters geven opties op waarmee de overeenkomende bewerking en een time-outinterval worden gewijzigd als er geen overeenkomst wordt gevonden.

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

Parameters

input
String

De tekenreeks om naar een overeenkomst te zoeken.

pattern
String

Het reguliere expressiepatroon dat moet overeenkomen.

replacement
String

De vervangende tekenreeks.

options
RegexOptions

Een bitsgewijze combinatie van de opsommingswaarden die opties bieden voor overeenkomende waarden.

matchTimeout
TimeSpan

Een time-outinterval of InfiniteMatchTimeout om aan te geven dat er geen time-out optreedt voor de methode.

Retouren

Een nieuwe tekenreeks die identiek is aan de invoertekenreeks, behalve dat de vervangende tekenreeks de plaats krijgt van elke overeenkomende tekenreeks. Als pattern deze niet overeenkomt in het huidige exemplaar, retourneert de methode het huidige exemplaar ongewijzigd.

Uitzonderingen

Er is een reguliere expressieparseringsfout opgetreden.

input, patternof replacement is null.

options is geen geldige bitsgewijze combinatie van RegexOptions waarden. -of- matchTimeout is negatief, nul of groter dan ongeveer 24 dagen.

Er is een time-out opgetreden.

Opmerkingen

De statische Replace(String, String, String, RegexOptions, TimeSpan) methoden zijn gelijk aan het maken van een Regex object met het opgegeven reguliere expressiepatroon en het aanroepen van de instantiemethode Replace(String, String).

De replacement parameter geeft de tekenreeks op die elke overeenkomst vervangt in input. replacement kan bestaan uit een combinatie van letterlijke tekst en vervangingen. Vervangingen zijn de enige reguliere expressietaalelementen die worden herkend in een vervangend patroon.

Omdat de methode ongewijzigd wordt geretourneerd input als er geen overeenkomst is, kunt u de ReferenceEquals(Object, Object) methode gebruiken om te bepalen of de methode vervangingen heeft aangebracht.

Als u opgeeft RightToLeft voor de options parameter, begint de zoekopdracht naar overeenkomsten aan het einde van de invoertekenreeks en gaat deze naar links. Anders begint de zoekopdracht aan het begin van de invoertekenreeks en gaat deze naar rechts.

De matchTimeout parameter geeft aan hoe lang een patroonkoppelingsmethode moet proberen een overeenkomst te vinden voordat er een time-out optreedt. Als u een time-outinterval instelt, voorkomt u dat reguliere expressies die afhankelijk zijn van overmatige backtracking niet meer reageren wanneer ze invoer verwerken die bijna overeenkomsten bevat. matchTimeout overschrijft een standaardtime-outwaarde die is gedefinieerd voor het toepassingsdomein waarin de methode wordt uitgevoerd.

Notities voor bellers

U wordt aangeraden de matchTimeout parameter in te stellen op een geschikte waarde, zoals twee seconden. Als u time-outs uitschakelt door op te InfiniteMatchTimeoutgeven, biedt de reguliere expressie-engine iets betere prestaties. Schakel echter alleen time-outs uit onder de volgende voorwaarden:

  • Wanneer de invoer die door een reguliere expressie wordt verwerkt, wordt afgeleid van een bekende en vertrouwde bron of bestaat uit statische tekst. Dit sluit tekst uit die dynamisch door gebruikers is ingevoerd.

  • Wanneer het reguliere expressiepatroon grondig is getest om ervoor te zorgen dat er efficiĆ«nt overeenkomsten, niet-overeenkomsten en bijna-overeenkomsten worden verwerkt.

  • Wanneer het reguliere expressiepatroon geen taalelementen bevat die bekend zijn dat ze overmatige backtracking veroorzaken bij het verwerken van een bijna-overeenkomst.

Zie ook

Van toepassing op

Replace(String, MatchEvaluator, Int32, Int32)

Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs

In een opgegeven invoersubtekenreeks vervangt u een opgegeven maximum aantal tekenreeksen dat overeenkomt met een normaal expressiepatroon door een tekenreeks die wordt geretourneerd door een MatchEvaluator gemachtigde.

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

Parameters

input
String

De tekenreeks om naar een overeenkomst te zoeken.

evaluator
MatchEvaluator

Een aangepaste methode die elke overeenkomst onderzoekt en de oorspronkelijke overeenkomende tekenreeks of een vervangende tekenreeks retourneert.

count
Int32

Het maximum aantal keren dat de vervanging plaatsvindt.

startat
Int32

De tekenpositie in de invoertekenreeks waar de zoekopdracht begint.

Retouren

Een nieuwe tekenreeks die identiek is aan de invoertekenreeks, behalve dat een vervangende tekenreeks de plaats van elke overeenkomende tekenreeks krijgt. Als het reguliere expressiepatroon niet overeenkomt in het huidige exemplaar, retourneert de methode het huidige exemplaar ongewijzigd.

Uitzonderingen

input of evaluator is null.

startat is kleiner dan nul of groter dan de lengte van input.

Er is een time-out opgetreden.

Opmerkingen

startatZie de sectie Opmerkingen van Match(String, Int32).

De methode geeft de eerste countMatch objecten door aan de evaluator gemachtigde.

Zie ook

Van toepassing op

Replace(String, String, MatchEvaluator, RegexOptions)

Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs

In een opgegeven invoertekenreeks vervangt u alle tekenreeksen die overeenkomen met een opgegeven reguliere expressie door een tekenreeks die wordt geretourneerd door een MatchEvaluator gemachtigde. Opgegeven opties wijzigen de overeenkomende bewerking.

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

Parameters

input
String

De tekenreeks om naar een overeenkomst te zoeken.

pattern
String

Het reguliere expressiepatroon dat moet overeenkomen.

evaluator
MatchEvaluator

Een aangepaste methode die elke overeenkomst onderzoekt en de oorspronkelijke overeenkomende tekenreeks of een vervangende tekenreeks retourneert.

options
RegexOptions

Een bitsgewijze combinatie van de opsommingswaarden die opties bieden voor overeenkomende waarden.

Retouren

Een nieuwe tekenreeks die identiek is aan de invoertekenreeks, behalve dat een vervangende tekenreeks de plaats van elke overeenkomende tekenreeks krijgt. Als pattern deze niet overeenkomt in het huidige exemplaar, retourneert de methode het huidige exemplaar ongewijzigd.

Uitzonderingen

Er is een reguliere expressieparseringsfout opgetreden.

input, patternof evaluator is null.

options is geen geldige bitsgewijze combinatie van RegexOptions waarden.

Er is een time-out opgetreden.

Opmerkingen

Deze methode is handig voor het vervangen van een reguliere expressie als aan een van de volgende voorwaarden is voldaan: de vervangende tekenreeks kan niet gemakkelijk worden opgegeven door een patroon voor het vervangen van een reguliere expressie, de vervangende tekenreeks resulteert in de verwerking van de overeenkomende tekenreeks of de vervangende tekenreeksresultaten van voorwaardelijke verwerking.

De methode is gelijk aan het aanroepen van de Matches(String, String) methode en het doorgeven van elk Match object in de geretourneerde MatchCollection object aan de evaluator gedelegeerde.

Omdat de methode ongewijzigd wordt geretourneerd input als er geen overeenkomst is, kunt u de ReferenceEquals(Object, Object) methode gebruiken om te bepalen of de methode vervangingen heeft aangebracht.

Als u opgeeft RightToLeft voor de options parameter, begint de zoekopdracht naar overeenkomsten aan het einde van de invoertekenreeks en gaat deze naar links. Anders begint de zoekopdracht aan het begin van de invoertekenreeks en gaat deze naar rechts.

Zie ook

Van toepassing op

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

Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs

In een opgegeven invoertekenreeks vervangt u alle subtekenreeksen die overeenkomen met een opgegeven reguliere expressie door een tekenreeks die wordt geretourneerd door een MatchEvaluator gemachtigde. Aanvullende parameters geven opties op waarmee de overeenkomende bewerking en een time-outinterval worden gewijzigd als er geen overeenkomst wordt gevonden.

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

Parameters

input
String

De tekenreeks om naar een overeenkomst te zoeken.

pattern
String

Het reguliere expressiepatroon dat moet overeenkomen.

evaluator
MatchEvaluator

Een aangepaste methode die elke overeenkomst onderzoekt en de oorspronkelijke overeenkomende tekenreeks of een vervangende tekenreeks retourneert.

options
RegexOptions

Een bitsgewijze combinatie van de opsommingswaarden die opties bieden voor overeenkomende waarden.

matchTimeout
TimeSpan

Een time-outinterval of InfiniteMatchTimeout om aan te geven dat er geen time-out optreedt voor de methode.

Retouren

Een nieuwe tekenreeks die identiek is aan de invoertekenreeks, behalve dat een vervangende tekenreeks de plaats van elke overeenkomende tekenreeks krijgt. Als pattern deze niet overeenkomt in het huidige exemplaar, retourneert de methode het huidige exemplaar ongewijzigd.

Uitzonderingen

Er is een reguliere expressieparseringsfout opgetreden.

input, patternof evaluator is null.

options is geen geldige bitsgewijze combinatie van RegexOptions waarden. -of- matchTimeout is negatief, nul of groter dan ongeveer 24 dagen.

Er is een time-out opgetreden.

Opmerkingen

Deze methode is handig voor het vervangen van een reguliere expressie als aan een van de volgende voorwaarden is voldaan: de vervangende tekenreeks kan niet gemakkelijk worden opgegeven door een patroon voor het vervangen van een reguliere expressie, de vervangende tekenreeks resulteert in de verwerking van de overeenkomende tekenreeks of de vervangende tekenreeksresultaten van voorwaardelijke verwerking.

De methode is gelijk aan het aanroepen van de Matches(String, String) methode en het doorgeven van elk Match object in de geretourneerde MatchCollection object aan de evaluator gedelegeerde.

Omdat de methode ongewijzigd wordt geretourneerd input als er geen overeenkomst is, kunt u de ReferenceEquals(Object, Object) methode gebruiken om te bepalen of de methode vervangingen heeft aangebracht.

Als u opgeeft RightToLeft voor de options parameter, begint de zoekopdracht naar overeenkomsten aan het einde van de invoertekenreeks en gaat deze naar links. Anders begint de zoekopdracht aan het begin van de invoertekenreeks en gaat deze naar rechts.

De matchTimeout parameter geeft aan hoe lang een patroonkoppelingsmethode moet proberen een overeenkomst te vinden voordat er een time-out optreedt. matchTimeout Hiermee wordt een standaardtime-outwaarde overschreven die is gedefinieerd voor het toepassingsdomein waarin de methode wordt uitgevoerd.

Notities voor bellers

U wordt aangeraden de matchTimeout parameter in te stellen op een geschikte waarde, zoals twee seconden. Als u time-outs uitschakelt door op te InfiniteMatchTimeoutgeven, biedt de reguliere expressie-engine iets betere prestaties. Schakel echter alleen time-outs uit onder de volgende voorwaarden:

  • Wanneer de invoer die door een reguliere expressie wordt verwerkt, wordt afgeleid van een bekende en vertrouwde bron of bestaat uit statische tekst. Dit sluit tekst uit die dynamisch door gebruikers is ingevoerd.

  • Wanneer het reguliere expressiepatroon grondig is getest om ervoor te zorgen dat er efficiĆ«nt overeenkomsten, niet-overeenkomsten en bijna-overeenkomsten worden verwerkt.

  • Wanneer het reguliere expressiepatroon geen taalelementen bevat die bekend zijn dat ze overmatige backtracking veroorzaken bij het verwerken van een bijna-overeenkomst.

Zie ook

Van toepassing op

Replace(String, String, Int32, Int32)

Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs

In een opgegeven invoersubtekenreeks vervangt u een opgegeven maximum aantal tekenreeksen dat overeenkomt met een normaal expressiepatroon met een opgegeven vervangende tekenreeks.

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

Parameters

input
String

De tekenreeks om naar een overeenkomst te zoeken.

replacement
String

De vervangende tekenreeks.

count
Int32

Het maximum aantal keren dat de vervanging kan plaatsvinden.

startat
Int32

De tekenpositie in de invoertekenreeks waar de zoekopdracht begint.

Retouren

Een nieuwe tekenreeks die identiek is aan de invoertekenreeks, behalve dat de vervangende tekenreeks de plaats krijgt van elke overeenkomende tekenreeks. Als het reguliere expressiepatroon niet overeenkomt in het huidige exemplaar, retourneert de methode het huidige exemplaar ongewijzigd.

Uitzonderingen

input of replacement is null.

startat is kleiner dan nul of groter dan de lengte van input.

Er is een time-out opgetreden.

Opmerkingen

startatZie de sectie Opmerkingen van Match(String, Int32).

De replacement parameter geeft de tekenreeks op die elke overeenkomst vervangt en vervangingen ondersteunt.

Als count dit negatief is, blijven vervangingen doorgaan naar het einde van de tekenreeks.

Zie ook

Van toepassing op

Replace(String, String, String)

Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs

In een opgegeven invoertekenreeks vervangt u alle tekenreeksen die overeenkomen met een opgegeven reguliere expressiepatroon door een opgegeven vervangende tekenreeks.

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

Parameters

input
String

De tekenreeks om naar een overeenkomst te zoeken.

pattern
String

Het reguliere expressiepatroon dat moet overeenkomen.

replacement
String

De vervangende tekenreeks.

Retouren

Een nieuwe tekenreeks die identiek is aan de invoertekenreeks, behalve dat de vervangende tekenreeks de plaats krijgt van elke overeenkomende tekenreeks. Als pattern deze niet overeenkomt in het huidige exemplaar, retourneert de methode het huidige exemplaar ongewijzigd.

Uitzonderingen

Er is een reguliere expressieparseringsfout opgetreden.

input, patternof replacement is null.

Er is een time-out opgetreden.

Opmerkingen

De statische Replace(String, String, String) methoden zijn gelijk aan het maken van een Regex object met het opgegeven reguliere expressiepatroon en het aanroepen van de instantiemethode Replace(String, String).

De replacement parameter geeft de tekenreeks op die elke overeenkomst vervangt in input. replacement kan bestaan uit een combinatie van letterlijke tekst en vervangingen. Vervangingen zijn de enige reguliere expressietaalelementen die worden herkend in een vervangend patroon.

Omdat de methode ongewijzigd wordt geretourneerd input als er geen overeenkomst is, kunt u de ReferenceEquals(Object, Object) methode gebruiken om te bepalen of de methode vervangingen heeft aangebracht.

Notities voor bellers

Deze methode treedt op na een interval dat gelijk is aan de standaardtime-outwaarde van het toepassingsdomein waarin deze wordt aangeroepen. Als er geen time-outwaarde is gedefinieerd voor het toepassingsdomein, wordt de waarde InfiniteMatchTimeout, waardoor er geen time-out optreedt voor de methode, gebruikt. De aanbevolen statische methode voor het vervangen van een patroonovereenkomst is Replace(String, String, String, RegexOptions, TimeSpan), waarmee u het time-outinterval kunt instellen.

Zie ook

Van toepassing op

Replace(String, String, MatchEvaluator)

Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs

In een opgegeven invoertekenreeks vervangt u alle tekenreeksen die overeenkomen met een opgegeven reguliere expressie door een tekenreeks die wordt geretourneerd door een MatchEvaluator gemachtigde.

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

Parameters

input
String

De tekenreeks om naar een overeenkomst te zoeken.

pattern
String

Het reguliere expressiepatroon dat moet overeenkomen.

evaluator
MatchEvaluator

Een aangepaste methode die elke overeenkomst onderzoekt en de oorspronkelijke overeenkomende tekenreeks of een vervangende tekenreeks retourneert.

Retouren

Een nieuwe tekenreeks die identiek is aan de invoertekenreeks, behalve dat een vervangende tekenreeks de plaats van elke overeenkomende tekenreeks krijgt. Als pattern deze niet overeenkomt in het huidige exemplaar, retourneert de methode het huidige exemplaar ongewijzigd.

Uitzonderingen

Er is een reguliere expressieparseringsfout opgetreden.

input, patternof evaluator is null.

Er is een time-out opgetreden.

Opmerkingen

Deze methode is handig voor het vervangen van een reguliere expressie als aan een van de volgende voorwaarden is voldaan: de vervangende tekenreeks kan niet gemakkelijk worden opgegeven door een patroon voor het vervangen van een reguliere expressie, de vervangende tekenreeks resulteert in de verwerking van de overeenkomende tekenreeks of de vervangende tekenreeksresultaten van voorwaardelijke verwerking.

De methode is gelijk aan het aanroepen van de Matches(String, String) methode en het doorgeven van elk Match object in de geretourneerde MatchCollection object aan de evaluator gedelegeerde.

Omdat de methode ongewijzigd wordt geretourneerd input als er geen overeenkomst is, kunt u de ReferenceEquals(Object, Object) methode gebruiken om te bepalen of de methode vervangingen heeft aangebracht.

Notities voor bellers

Deze methode treedt op na een interval dat gelijk is aan de standaardtime-outwaarde van het toepassingsdomein waarin deze wordt aangeroepen. Als er geen time-outwaarde is gedefinieerd voor het toepassingsdomein, wordt de waarde InfiniteMatchTimeout, waardoor er geen time-out optreedt voor de methode, gebruikt. De aanbevolen statische methode voor het evalueren en vervangen van een patroonovereenkomst is Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan), waarmee u het time-outinterval kunt instellen.

Zie ook

Van toepassing op

Replace(String, String, Int32)

Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs

In een opgegeven invoertekenreeks vervangt u een opgegeven maximum aantal tekenreeksen dat overeenkomt met een normaal expressiepatroon met een opgegeven vervangende tekenreeks.

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

Parameters

input
String

De tekenreeks om naar een overeenkomst te zoeken.

replacement
String

De vervangende tekenreeks.

count
Int32

Het maximum aantal keren dat de vervanging kan plaatsvinden.

Retouren

Een nieuwe tekenreeks die identiek is aan de invoertekenreeks, behalve dat de vervangende tekenreeks de plaats krijgt van elke overeenkomende tekenreeks. Als het reguliere expressiepatroon niet overeenkomt in het huidige exemplaar, retourneert de methode het huidige exemplaar ongewijzigd.

Uitzonderingen

input of replacement is null.

Er is een time-out opgetreden.

Opmerkingen

De zoekopdracht begint aan het begin van de input tekenreeks. De replacement parameter geeft de tekenreeks op die elke overeenkomst vervangt en vervangingen ondersteunt.

Als count dit negatief is, blijven vervangingen doorgaan naar het einde van de tekenreeks.

Omdat de methode ongewijzigd wordt geretourneerd input als er geen overeenkomst is, kunt u de ReferenceEquals(Object, Object) methode gebruiken om te bepalen of de methode vervangingen heeft aangebracht.

Zie ook

Van toepassing op

Replace(String, MatchEvaluator)

Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs

In een opgegeven invoertekenreeks vervangt u alle tekenreeksen die overeenkomen met een opgegeven reguliere expressie door een tekenreeks die wordt geretourneerd door een MatchEvaluator gemachtigde.

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

Parameters

input
String

De tekenreeks om naar een overeenkomst te zoeken.

evaluator
MatchEvaluator

Een aangepaste methode die elke overeenkomst onderzoekt en de oorspronkelijke overeenkomende tekenreeks of een vervangende tekenreeks retourneert.

Retouren

Een nieuwe tekenreeks die identiek is aan de invoertekenreeks, behalve dat een vervangende tekenreeks de plaats van elke overeenkomende tekenreeks krijgt. Als het reguliere expressiepatroon niet overeenkomt in het huidige exemplaar, retourneert de methode het huidige exemplaar ongewijzigd.

Uitzonderingen

input of evaluator is null.

Er is een time-out opgetreden.

Opmerkingen

Deze methode is handig voor het vervangen van een reguliere expressie als aan een van de volgende voorwaarden is voldaan: de vervangende tekenreeks kan niet gemakkelijk worden opgegeven door een patroon voor het vervangen van een reguliere expressie, de vervangende tekenreeks resulteert in de verwerking van de overeenkomende tekenreeks of de vervangende tekenreeksresultaten van voorwaardelijke verwerking.

De methode is gelijk aan het aanroepen van de Matches(String) methode en het doorgeven van elk Match object in de geretourneerde MatchCollection object aan de evaluator gedelegeerde.

Omdat de methode ongewijzigd wordt geretourneerd input als er geen overeenkomst is, kunt u de ReferenceEquals(Object, Object) methode gebruiken om te bepalen of de methode vervangingen heeft aangebracht.

Zie ook

Van toepassing op

Replace(String, String)

Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs

In een opgegeven invoertekenreeks vervangt u alle tekenreeksen die overeenkomen met een normaal expressiepatroon met een opgegeven vervangende tekenreeks.

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

Parameters

input
String

De tekenreeks om naar een overeenkomst te zoeken.

replacement
String

De vervangende tekenreeks.

Retouren

Een nieuwe tekenreeks die identiek is aan de invoertekenreeks, behalve dat de vervangende tekenreeks de plaats krijgt van elke overeenkomende tekenreeks. Als het reguliere expressiepatroon niet overeenkomt in het huidige exemplaar, retourneert de methode het huidige exemplaar ongewijzigd.

Uitzonderingen

input of replacement is null.

Er is een time-out opgetreden.

Opmerkingen

Het zoeken naar het patroon begint aan het begin van de input tekenreeks.

De replacement parameter geeft de tekenreeks op die elke overeenkomst vervangt. replacement kan bestaan uit een combinatie van letterlijke tekst en vervangingen. Vervangingen zijn de enige reguliere expressietaalelementen die worden herkend in een vervangend patroon.

Omdat de methode ongewijzigd wordt geretourneerd input als er geen overeenkomst is, kunt u de ReferenceEquals(Object, Object) methode gebruiken om te bepalen of de methode vervangingen heeft aangebracht.

Zie ook

Van toepassing op

Replace(String, MatchEvaluator, Int32)

Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs
Bron:
Regex.Replace.cs

In een opgegeven invoertekenreeks vervangt u een opgegeven maximum aantal tekenreeksen dat overeenkomt met een normaal expressiepatroon door een tekenreeks die wordt geretourneerd door een MatchEvaluator gemachtigde.

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

Parameters

input
String

De tekenreeks om naar een overeenkomst te zoeken.

evaluator
MatchEvaluator

Een aangepaste methode die elke overeenkomst onderzoekt en de oorspronkelijke overeenkomende tekenreeks of een vervangende tekenreeks retourneert.

count
Int32

Het maximum aantal keren dat de vervanging plaatsvindt.

Retouren

Een nieuwe tekenreeks die identiek is aan de invoertekenreeks, behalve dat een vervangende tekenreeks de plaats van elke overeenkomende tekenreeks krijgt. Als het reguliere expressiepatroon niet overeenkomt in het huidige exemplaar, retourneert de methode het huidige exemplaar ongewijzigd.

Uitzonderingen

input of evaluator is null.

Er is een time-out opgetreden.

Opmerkingen

Deze methode is handig voor het vervangen van een reguliere expressie als aan een van de volgende voorwaarden is voldaan: de vervangende tekenreeks kan niet gemakkelijk worden opgegeven door een patroon voor het vervangen van een reguliere expressie, de vervangende tekenreeks resulteert in de verwerking van de overeenkomende tekenreeks of de vervangende tekenreeksresultaten van voorwaardelijke verwerking.

De methode is gelijk aan het aanroepen van de Matches(String) methode en het doorgeven van de eersteMatchcountobjecten in de geretourneerde MatchCollection aan de evaluator gemachtigde.

Als count dit negatief is, blijven vervangingen doorgaan naar het einde van de tekenreeks.

Omdat de methode ongewijzigd wordt geretourneerd input als er geen overeenkomst is, kunt u de ReferenceEquals(Object, Object) methode gebruiken om te bepalen of de methode vervangingen heeft aangebracht.

Zie ook

Van toepassing op