Regex.Replace Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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
- RegexOptions
- Vervangingen in reguliere expressies
- Taalelementen voor reguliere expressies
- Backtracking in reguliere expressies
- Best-procedures voor reguliere expressies in .NET
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
- MatchEvaluator
- RegexOptions
- Vervangingen in reguliere expressies
- Taalelementen voor reguliere expressies
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
- RegexOptions
- Vervangingen in reguliere expressies
- Taalelementen voor reguliere expressies
- Backtracking in reguliere expressies
- Best-procedures voor reguliere expressies in .NET
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.