Regex.Replace Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
I en angiven indatasträng ersätter strängar som matchar ett mönster för reguljära uttryck med en angiven ersättningssträng.
Överlagringar
| Name | Description |
|---|---|
| Replace(String, String, String, RegexOptions) |
I en angiven indatasträng ersätter alla strängar som matchar ett angivet reguljärt uttryck med en angiven ersättningssträng. Angivna alternativ ändrar matchningsåtgärden. |
| Replace(String, String, String, RegexOptions, TimeSpan) |
I en angiven indatasträng ersätter alla strängar som matchar ett angivet reguljärt uttryck med en angiven ersättningssträng. Ytterligare parametrar anger alternativ som ändrar matchningsåtgärden och ett tidsgränsintervall om ingen matchning hittas. |
| Replace(String, MatchEvaluator, Int32, Int32) |
I en angiven indatadelsträng ersätter ett angivet maximalt antal strängar som matchar ett mönster för reguljära uttryck med en sträng som returneras av ett MatchEvaluator ombud. |
| Replace(String, String, MatchEvaluator, RegexOptions) |
I en angiven indatasträng ersätter alla strängar som matchar ett angivet reguljärt uttryck med en sträng som returneras av ett MatchEvaluator ombud. Angivna alternativ ändrar matchningsåtgärden. |
| Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan) |
I en angiven indatasträng ersätter alla delsträngar som matchar ett angivet reguljärt uttryck med en sträng som returneras av ett MatchEvaluator ombud. Ytterligare parametrar anger alternativ som ändrar matchningsåtgärden och ett tidsgränsintervall om ingen matchning hittas. |
| Replace(String, String, Int32, Int32) |
I en angiven indatadelsträng ersätter ett angivet maximalt antal strängar som matchar ett mönster för reguljära uttryck med en angiven ersättningssträng. |
| Replace(String, String, String) |
I en angiven indatasträng ersätter alla strängar som matchar ett angivet mönster för reguljära uttryck med en angiven ersättningssträng. |
| Replace(String, String, MatchEvaluator) |
I en angiven indatasträng ersätter alla strängar som matchar ett angivet reguljärt uttryck med en sträng som returneras av ett MatchEvaluator ombud. |
| Replace(String, String, Int32) |
I en angiven indatasträng ersätter ett angivet maximalt antal strängar som matchar ett mönster för reguljära uttryck med en angiven ersättningssträng. |
| Replace(String, MatchEvaluator) |
I en angiven indatasträng ersätter alla strängar som matchar ett angivet reguljärt uttryck med en sträng som returneras av ett MatchEvaluator ombud. |
| Replace(String, String) |
I en angiven indatasträng ersätter alla strängar som matchar ett mönster för reguljära uttryck med en angiven ersättningssträng. |
| Replace(String, MatchEvaluator, Int32) |
I en angiven indatasträng ersätter ett angivet maximalt antal strängar som matchar ett mönster för reguljära uttryck med en sträng som returneras av ett MatchEvaluator ombud. |
Replace(String, String, String, RegexOptions)
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
I en angiven indatasträng ersätter alla strängar som matchar ett angivet reguljärt uttryck med en angiven ersättningssträng. Angivna alternativ ändrar matchningsåtgärden.
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
Parametrar
- input
- String
Strängen för att söka efter en matchning.
- pattern
- String
Det reguljära uttrycksmönster som ska matchas.
- replacement
- String
Ersättningssträngen.
- options
- RegexOptions
En bitvis kombination av uppräkningsvärdena som ger alternativ för matchning.
Returer
En ny sträng som är identisk med indatasträngen, förutom att ersättningssträngen ersätter varje matchad sträng. Om pattern inte matchas i den aktuella instansen returnerar metoden den aktuella instansen oförändrad.
Undantag
Ett fel uppstod vid parsning av reguljära uttryck.
input, pattern, eller replacement är null.
options är inte en giltig bitvis kombination av RegexOptions värden.
En timeout inträffade.
Kommentarer
De statiska Replace(String, String, String, RegexOptions) metoderna motsvarar konstruera ett Regex objekt med det angivna reguljära uttrycksmönstret och anropa instansmetoden Replace(String, String).
Parametern replacement anger strängen som ersätter varje matchning i input.
replacement kan bestå av valfri kombination av literaltext och ersättningar. Substitutioner är de enda språkelementen för reguljära uttryck som identifieras i ett ersättningsmönster.
Eftersom metoden returnerar input oförändrad om det inte finns någon matchning kan du använda ReferenceEquals(Object, Object) metoden för att avgöra om metoden har gjort några ersättningar.
Om du anger RightToLeft parametern options börjar sökningen efter matchningar i slutet av indatasträngen och flyttas åt vänster. Annars börjar sökningen i början av indatasträngen och flyttas åt höger.
Anteckningar till anropare
Den här metoden överskrider tidsgränsen efter ett intervall som är lika med standardvärdet för timeout för den programdomän där den anropas. Om ett timeout-värde inte har definierats för programdomänen används värdet InfiniteMatchTimeout, som förhindrar att metoden överskrider tidsgränsen. Den rekommenderade statiska metoden för att ersätta en mönstermatchning är Replace(String, String, String, RegexOptions, TimeSpan), vilket gör att du kan ange tidsgränsintervallet.
Se även
Gäller för
Replace(String, String, String, RegexOptions, TimeSpan)
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
I en angiven indatasträng ersätter alla strängar som matchar ett angivet reguljärt uttryck med en angiven ersättningssträng. Ytterligare parametrar anger alternativ som ändrar matchningsåtgärden och ett tidsgränsintervall om ingen matchning hittas.
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
Parametrar
- input
- String
Strängen för att söka efter en matchning.
- pattern
- String
Det reguljära uttrycksmönster som ska matchas.
- replacement
- String
Ersättningssträngen.
- options
- RegexOptions
En bitvis kombination av uppräkningsvärdena som ger alternativ för matchning.
- matchTimeout
- TimeSpan
Ett tidsgränsintervall, eller InfiniteMatchTimeout för att indikera att metoden inte bör överskrida tidsgränsen.
Returer
En ny sträng som är identisk med indatasträngen, förutom att ersättningssträngen ersätter varje matchad sträng. Om pattern inte matchas i den aktuella instansen returnerar metoden den aktuella instansen oförändrad.
Undantag
Ett fel uppstod vid parsning av reguljära uttryck.
input, pattern, eller replacement är null.
options är inte en giltig bitvis kombination av RegexOptions värden.
-or- matchTimeout är negativ, noll eller större än cirka 24 dagar.
En timeout inträffade.
Kommentarer
De statiska Replace(String, String, String, RegexOptions, TimeSpan) metoderna motsvarar konstruera ett Regex objekt med det angivna reguljära uttrycksmönstret och anropa instansmetoden Replace(String, String).
Parametern replacement anger strängen som ersätter varje matchning i input.
replacement kan bestå av valfri kombination av literaltext och ersättningar. Substitutioner är de enda språkelementen för reguljära uttryck som identifieras i ett ersättningsmönster.
Eftersom metoden returnerar input oförändrad om det inte finns någon matchning kan du använda ReferenceEquals(Object, Object) metoden för att avgöra om metoden har gjort några ersättningar.
Om du anger RightToLeft parametern options börjar sökningen efter matchningar i slutet av indatasträngen och flyttas åt vänster. Annars börjar sökningen i början av indatasträngen och flyttas åt höger.
Parametern matchTimeout anger hur länge en mönstermatchningsmetod ska försöka hitta en matchning innan tidsgränsen uppnås. Om du anger ett tidsgränsintervall förhindras reguljära uttryck som förlitar sig på överdriven bakåtspårning från att verka sluta svara när de bearbetar indata som innehåller nära matchningar.
matchTimeout åsidosätter alla standardvärden för timeout som definierats för programdomänen där metoden körs.
Anteckningar till anropare
Vi rekommenderar att du anger parametern matchTimeout till ett lämpligt värde, till exempel två sekunder. Om du inaktiverar tidsgränser genom att ange ger motorn för reguljära InfiniteMatchTimeoututtryck något bättre prestanda. Du bör dock inaktivera tidsgränser endast under följande villkor:
När indata som bearbetas av ett reguljärt uttryck härleds från en känd och betrodd källa eller består av statisk text. Detta exkluderar text som har matats in dynamiskt av användare.
När mönstret för reguljära uttryck har testats noggrant för att säkerställa att det effektivt hanterar matchningar, icke-matchningar och nära matchningar.
När det reguljära uttrycksmönstret inte innehåller några språkelement som är kända för att orsaka överdriven bakåtspårning vid bearbetning av en nära matchning.
Se även
- RegexOptions
- Ersättningar i reguljära uttryck
- Språkelement för reguljära uttryck
- Bakåtspårning i reguljära uttryck
- Bäste metoder för reguljära uttryck i .NET
Gäller för
Replace(String, MatchEvaluator, Int32, Int32)
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
I en angiven indatadelsträng ersätter ett angivet maximalt antal strängar som matchar ett mönster för reguljära uttryck med en sträng som returneras av ett MatchEvaluator ombud.
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
Parametrar
- input
- String
Strängen för att söka efter en matchning.
- evaluator
- MatchEvaluator
En anpassad metod som undersöker varje matchning och returnerar antingen den ursprungliga matchade strängen eller en ersättningssträng.
- count
- Int32
Det maximala antalet gånger som ersättningen sker.
- startat
- Int32
Teckenpositionen i indatasträngen där sökningen börjar.
Returer
En ny sträng som är identisk med indatasträngen, förutom att en ersättningssträng ersätter varje matchad sträng. Om mönstret för reguljära uttryck inte matchas i den aktuella instansen returnerar metoden den aktuella instansen oförändrad.
Undantag
input eller evaluator är null.
startat är mindre än noll eller större än längden på input.
En timeout inträffade.
Kommentarer
Mer information om startatfinns i avsnittet Kommentarer i Match(String, Int32).
Metoden skickar de första countMatch objekten till ombudet evaluator .
Se även
Gäller för
Replace(String, String, MatchEvaluator, RegexOptions)
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
I en angiven indatasträng ersätter alla strängar som matchar ett angivet reguljärt uttryck med en sträng som returneras av ett MatchEvaluator ombud. Angivna alternativ ändrar matchningsåtgärden.
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
Parametrar
- input
- String
Strängen för att söka efter en matchning.
- pattern
- String
Det reguljära uttrycksmönster som ska matchas.
- evaluator
- MatchEvaluator
En anpassad metod som undersöker varje matchning och returnerar antingen den ursprungliga matchade strängen eller en ersättningssträng.
- options
- RegexOptions
En bitvis kombination av uppräkningsvärdena som ger alternativ för matchning.
Returer
En ny sträng som är identisk med indatasträngen, förutom att en ersättningssträng ersätter varje matchad sträng. Om pattern inte matchas i den aktuella instansen returnerar metoden den aktuella instansen oförändrad.
Undantag
Ett fel uppstod vid parsning av reguljära uttryck.
input, pattern, eller evaluator är null.
options är inte en giltig bitvis kombination av RegexOptions värden.
En timeout inträffade.
Kommentarer
Den här metoden är användbar för att ersätta en reguljär uttrycksmatchning om något av följande villkor är sant: ersättningssträngen kan inte enkelt anges med ett mönster för ersättning av reguljära uttryck, ersättningssträngen resulterar från bearbetning av den matchade strängen eller ersättningssträngens resultat från villkorsstyrd bearbetning.
Metoden motsvarar att anropa Matches(String, String) metoden och skicka varje Match objekt i det som returneras MatchCollection till ombudet evaluator .
Eftersom metoden returnerar input oförändrad om det inte finns någon matchning kan du använda ReferenceEquals(Object, Object) metoden för att avgöra om metoden har gjort några ersättningar.
Om du anger RightToLeft parametern options börjar sökningen efter matchningar i slutet av indatasträngen och flyttas åt vänster. Annars börjar sökningen i början av indatasträngen och flyttas åt höger.
Se även
Gäller för
Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan)
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
I en angiven indatasträng ersätter alla delsträngar som matchar ett angivet reguljärt uttryck med en sträng som returneras av ett MatchEvaluator ombud. Ytterligare parametrar anger alternativ som ändrar matchningsåtgärden och ett tidsgränsintervall om ingen matchning hittas.
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
Parametrar
- input
- String
Strängen för att söka efter en matchning.
- pattern
- String
Det reguljära uttrycksmönster som ska matchas.
- evaluator
- MatchEvaluator
En anpassad metod som undersöker varje matchning och returnerar antingen den ursprungliga matchade strängen eller en ersättningssträng.
- options
- RegexOptions
En bitvis kombination av uppräkningsvärdena som ger alternativ för matchning.
- matchTimeout
- TimeSpan
Ett tidsgränsintervall, eller InfiniteMatchTimeout för att indikera att metoden inte bör överskrida tidsgränsen.
Returer
En ny sträng som är identisk med indatasträngen, förutom att en ersättningssträng ersätter varje matchad sträng. Om pattern inte matchas i den aktuella instansen returnerar metoden den aktuella instansen oförändrad.
Undantag
Ett fel uppstod vid parsning av reguljära uttryck.
input, pattern, eller evaluator är null.
options är inte en giltig bitvis kombination av RegexOptions värden.
-or- matchTimeout är negativ, noll eller större än cirka 24 dagar.
En timeout inträffade.
Kommentarer
Den här metoden är användbar för att ersätta en reguljär uttrycksmatchning om något av följande villkor är sant: ersättningssträngen kan inte enkelt anges med ett mönster för ersättning av reguljära uttryck, ersättningssträngen resulterar från bearbetning av den matchade strängen eller ersättningssträngens resultat från villkorsstyrd bearbetning.
Metoden motsvarar att anropa Matches(String, String) metoden och skicka varje Match objekt i det som returneras MatchCollection till ombudet evaluator .
Eftersom metoden returnerar input oförändrad om det inte finns någon matchning kan du använda ReferenceEquals(Object, Object) metoden för att avgöra om metoden har gjort några ersättningar.
Om du anger RightToLeft parametern options börjar sökningen efter matchningar i slutet av indatasträngen och flyttas åt vänster. Annars börjar sökningen i början av indatasträngen och flyttas åt höger.
Parametern matchTimeout anger hur länge en mönstermatchningsmetod ska försöka hitta en matchning innan tidsgränsen överskrids. matchTimeout Åsidosätter alla standardvärden för tidsgränser som definierats för programdomänen där metoden körs.
Anteckningar till anropare
Vi rekommenderar att du anger parametern matchTimeout till ett lämpligt värde, till exempel två sekunder. Om du inaktiverar tidsgränser genom att ange ger motorn för reguljära InfiniteMatchTimeoututtryck något bättre prestanda. Du bör dock inaktivera tidsgränser endast under följande villkor:
När indata som bearbetas av ett reguljärt uttryck härleds från en känd och betrodd källa eller består av statisk text. Detta exkluderar text som har matats in dynamiskt av användare.
När mönstret för reguljära uttryck har testats noggrant för att säkerställa att det effektivt hanterar matchningar, icke-matchningar och nära matchningar.
När det reguljära uttrycksmönstret inte innehåller några språkelement som är kända för att orsaka överdriven bakåtspårning vid bearbetning av en nära matchning.
Se även
- RegexOptions
- Ersättningar i reguljära uttryck
- Språkelement för reguljära uttryck
- Bakåtspårning i reguljära uttryck
- Bäste metoder för reguljära uttryck i .NET
Gäller för
Replace(String, String, Int32, Int32)
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
I en angiven indatadelsträng ersätter ett angivet maximalt antal strängar som matchar ett mönster för reguljära uttryck med en angiven ersättningssträng.
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
Parametrar
- input
- String
Strängen för att söka efter en matchning.
- replacement
- String
Ersättningssträngen.
- count
- Int32
Det maximala antalet gånger som ersättningen kan ske.
- startat
- Int32
Teckenpositionen i indatasträngen där sökningen börjar.
Returer
En ny sträng som är identisk med indatasträngen, förutom att ersättningssträngen ersätter varje matchad sträng. Om mönstret för reguljära uttryck inte matchas i den aktuella instansen returnerar metoden den aktuella instansen oförändrad.
Undantag
input eller replacement är null.
startat är mindre än noll eller större än längden på input.
En timeout inträffade.
Kommentarer
Mer information om startatfinns i avsnittet Kommentarer i Match(String, Int32).
Parametern replacement anger den sträng som ersätter varje matchning och stöder ersättningar.
Om count är negativt fortsätter ersättningarna till slutet av strängen.
Se även
Gäller för
Replace(String, String, String)
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
I en angiven indatasträng ersätter alla strängar som matchar ett angivet mönster för reguljära uttryck med en angiven ersättningssträng.
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
Parametrar
- input
- String
Strängen för att söka efter en matchning.
- pattern
- String
Det reguljära uttrycksmönster som ska matchas.
- replacement
- String
Ersättningssträngen.
Returer
En ny sträng som är identisk med indatasträngen, förutom att ersättningssträngen ersätter varje matchad sträng. Om pattern inte matchas i den aktuella instansen returnerar metoden den aktuella instansen oförändrad.
Undantag
Ett fel uppstod vid parsning av reguljära uttryck.
input, pattern, eller replacement är null.
En timeout inträffade.
Kommentarer
De statiska Replace(String, String, String) metoderna motsvarar konstruera ett Regex objekt med det angivna reguljära uttrycksmönstret och anropa instansmetoden Replace(String, String).
Parametern replacement anger strängen som ersätter varje matchning i input.
replacement kan bestå av valfri kombination av literaltext och ersättningar. Substitutioner är de enda språkelementen för reguljära uttryck som identifieras i ett ersättningsmönster.
Eftersom metoden returnerar input oförändrad om det inte finns någon matchning kan du använda ReferenceEquals(Object, Object) metoden för att avgöra om metoden har gjort några ersättningar.
Anteckningar till anropare
Den här metoden överskrider tidsgränsen efter ett intervall som är lika med standardvärdet för timeout för den programdomän där den anropas. Om ett timeout-värde inte har definierats för programdomänen används värdet InfiniteMatchTimeout, som förhindrar att metoden överskrider tidsgränsen. Den rekommenderade statiska metoden för att ersätta en mönstermatchning är Replace(String, String, String, RegexOptions, TimeSpan), vilket gör att du kan ange tidsgränsintervallet.
Se även
Gäller för
Replace(String, String, MatchEvaluator)
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
I en angiven indatasträng ersätter alla strängar som matchar ett angivet reguljärt uttryck med en sträng som returneras av ett MatchEvaluator ombud.
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
Parametrar
- input
- String
Strängen för att söka efter en matchning.
- pattern
- String
Det reguljära uttrycksmönster som ska matchas.
- evaluator
- MatchEvaluator
En anpassad metod som undersöker varje matchning och returnerar antingen den ursprungliga matchade strängen eller en ersättningssträng.
Returer
En ny sträng som är identisk med indatasträngen, förutom att en ersättningssträng ersätter varje matchad sträng. Om pattern inte matchas i den aktuella instansen returnerar metoden den aktuella instansen oförändrad.
Undantag
Ett fel uppstod vid parsning av reguljära uttryck.
input, pattern, eller evaluator är null.
En timeout inträffade.
Kommentarer
Den här metoden är användbar för att ersätta en reguljär uttrycksmatchning om något av följande villkor är sant: ersättningssträngen kan inte enkelt anges med ett mönster för ersättning av reguljära uttryck, ersättningssträngen resulterar från bearbetning av den matchade strängen eller ersättningssträngens resultat från villkorsstyrd bearbetning.
Metoden motsvarar att anropa Matches(String, String) metoden och skicka varje Match objekt i det som returneras MatchCollection till ombudet evaluator .
Eftersom metoden returnerar input oförändrad om det inte finns någon matchning kan du använda ReferenceEquals(Object, Object) metoden för att avgöra om metoden har gjort några ersättningar.
Anteckningar till anropare
Den här metoden överskrider tidsgränsen efter ett intervall som är lika med standardvärdet för timeout för den programdomän där den anropas. Om ett timeout-värde inte har definierats för programdomänen används värdet InfiniteMatchTimeout, som förhindrar att metoden överskrider tidsgränsen. Den rekommenderade statiska metoden för att utvärdera och ersätta en mönstermatchning är Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan), vilket gör att du kan ange tidsgränsintervallet.
Se även
Gäller för
Replace(String, String, Int32)
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
I en angiven indatasträng ersätter ett angivet maximalt antal strängar som matchar ett mönster för reguljära uttryck med en angiven ersättningssträng.
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
Parametrar
- input
- String
Strängen för att söka efter en matchning.
- replacement
- String
Ersättningssträngen.
- count
- Int32
Det maximala antalet gånger som ersättningen kan ske.
Returer
En ny sträng som är identisk med indatasträngen, förutom att ersättningssträngen ersätter varje matchad sträng. Om mönstret för reguljära uttryck inte matchas i den aktuella instansen returnerar metoden den aktuella instansen oförändrad.
Undantag
input eller replacement är null.
En timeout inträffade.
Kommentarer
Sökningen börjar i början av strängen input . Parametern replacement anger den sträng som ersätter varje matchning och stöder ersättningar.
Om count är negativt fortsätter ersättningarna till slutet av strängen.
Eftersom metoden returnerar input oförändrad om det inte finns någon matchning kan du använda ReferenceEquals(Object, Object) metoden för att avgöra om metoden har gjort några ersättningar.
Se även
Gäller för
Replace(String, MatchEvaluator)
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
I en angiven indatasträng ersätter alla strängar som matchar ett angivet reguljärt uttryck med en sträng som returneras av ett MatchEvaluator ombud.
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
Parametrar
- input
- String
Strängen för att söka efter en matchning.
- evaluator
- MatchEvaluator
En anpassad metod som undersöker varje matchning och returnerar antingen den ursprungliga matchade strängen eller en ersättningssträng.
Returer
En ny sträng som är identisk med indatasträngen, förutom att en ersättningssträng ersätter varje matchad sträng. Om mönstret för reguljära uttryck inte matchas i den aktuella instansen returnerar metoden den aktuella instansen oförändrad.
Undantag
input eller evaluator är null.
En timeout inträffade.
Kommentarer
Den här metoden är användbar för att ersätta en reguljär uttrycksmatchning om något av följande villkor är sant: ersättningssträngen kan inte enkelt anges med ett mönster för ersättning av reguljära uttryck, ersättningssträngen resulterar från bearbetning av den matchade strängen eller ersättningssträngens resultat från villkorsstyrd bearbetning.
Metoden motsvarar att anropa Matches(String) metoden och skicka varje Match objekt i det som returneras MatchCollection till ombudet evaluator .
Eftersom metoden returnerar input oförändrad om det inte finns någon matchning kan du använda ReferenceEquals(Object, Object) metoden för att avgöra om metoden har gjort några ersättningar.
Se även
Gäller för
Replace(String, String)
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
I en angiven indatasträng ersätter alla strängar som matchar ett mönster för reguljära uttryck med en angiven ersättningssträng.
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
Parametrar
- input
- String
Strängen för att söka efter en matchning.
- replacement
- String
Ersättningssträngen.
Returer
En ny sträng som är identisk med indatasträngen, förutom att ersättningssträngen ersätter varje matchad sträng. Om mönstret för reguljära uttryck inte matchas i den aktuella instansen returnerar metoden den aktuella instansen oförändrad.
Undantag
input eller replacement är null.
En timeout inträffade.
Kommentarer
Sökningen efter mönstret börjar i början av strängen input .
Parametern replacement anger den sträng som ersätter varje matchning.
replacement kan bestå av valfri kombination av literaltext och ersättningar. Substitutioner är de enda språkelementen för reguljära uttryck som identifieras i ett ersättningsmönster.
Eftersom metoden returnerar input oförändrad om det inte finns någon matchning kan du använda ReferenceEquals(Object, Object) metoden för att avgöra om metoden har gjort några ersättningar.
Se även
Gäller för
Replace(String, MatchEvaluator, Int32)
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
- Källa:
- Regex.Replace.cs
I en angiven indatasträng ersätter ett angivet maximalt antal strängar som matchar ett mönster för reguljära uttryck med en sträng som returneras av ett MatchEvaluator ombud.
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
Parametrar
- input
- String
Strängen för att söka efter en matchning.
- evaluator
- MatchEvaluator
En anpassad metod som undersöker varje matchning och returnerar antingen den ursprungliga matchade strängen eller en ersättningssträng.
- count
- Int32
Det maximala antalet gånger som ersättningen sker.
Returer
En ny sträng som är identisk med indatasträngen, förutom att en ersättningssträng ersätter varje matchad sträng. Om mönstret för reguljära uttryck inte matchas i den aktuella instansen returnerar metoden den aktuella instansen oförändrad.
Undantag
input eller evaluator är null.
En timeout inträffade.
Kommentarer
Den här metoden är användbar för att ersätta en reguljär uttrycksmatchning om något av följande villkor är sant: ersättningssträngen kan inte enkelt anges med ett mönster för ersättning av reguljära uttryck, ersättningssträngen resulterar från bearbetning av den matchade strängen eller ersättningssträngens resultat från villkorsstyrd bearbetning.
Metoden motsvarar att anropa Matches(String) metoden och skicka de första countMatch objekten i det som returneras MatchCollection till ombudet evaluator .
Om count är negativt fortsätter ersättningarna till slutet av strängen.
Eftersom metoden returnerar input oförändrad om det inte finns någon matchning kan du använda ReferenceEquals(Object, Object) metoden för att avgöra om metoden har gjort några ersättningar.