Regex.Replace Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ersetzt in einer angegebenen Eingabezeichenfolge Zeichenfolgen, die einem Muster für reguläre Ausdrücke mit einer angegebenen Ersetzungszeichenfolge entsprechen.
Überlädt
| Name | Beschreibung |
|---|---|
| Replace(String, String, String, RegexOptions) |
Ersetzt in einer angegebenen Eingabezeichenfolge alle Zeichenfolgen, die einem angegebenen regulären Ausdruck entsprechen, durch eine angegebene Ersetzungszeichenfolge. Angegebene Optionen ändern den Abgleichsvorgang. |
| Replace(String, String, String, RegexOptions, TimeSpan) |
Ersetzt in einer angegebenen Eingabezeichenfolge alle Zeichenfolgen, die einem angegebenen regulären Ausdruck entsprechen, durch eine angegebene Ersetzungszeichenfolge. Zusätzliche Parameter geben Optionen an, die den Abgleichsvorgang und ein Timeoutintervall ändern, wenn keine Übereinstimmung gefunden wird. |
| Replace(String, MatchEvaluator, Int32, Int32) |
Ersetzt in einer angegebenen Eingabeunterzeichenfolge eine angegebene maximale Anzahl von Zeichenfolgen, die einem Muster für reguläre Ausdrücke entsprechen, durch eine von einem MatchEvaluator Delegaten zurückgegebene Zeichenfolge. |
| Replace(String, String, MatchEvaluator, RegexOptions) |
Ersetzt in einer angegebenen Eingabezeichenfolge alle Zeichenfolgen, die einem angegebenen regulären Ausdruck entsprechen, durch eine von einem MatchEvaluator Delegaten zurückgegebene Zeichenfolge. Angegebene Optionen ändern den Abgleichsvorgang. |
| Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan) |
Ersetzt in einer angegebenen Eingabezeichenfolge alle Teilzeichenfolgen, die einem angegebenen regulären Ausdruck entsprechen, durch eine von einem MatchEvaluator Delegaten zurückgegebene Zeichenfolge. Zusätzliche Parameter geben Optionen an, die den Abgleichsvorgang und ein Timeoutintervall ändern, wenn keine Übereinstimmung gefunden wird. |
| Replace(String, String, Int32, Int32) |
Ersetzt in einer angegebenen Eingabeunterzeichenfolge eine angegebene maximale Anzahl von Zeichenfolgen, die einem Muster für reguläre Ausdrücke mit einer angegebenen Ersetzungszeichenfolge entsprechen. |
| Replace(String, String, String) |
Ersetzt in einer angegebenen Eingabezeichenfolge alle Zeichenfolgen, die mit einem angegebenen Muster für reguläre Ausdrücke übereinstimmen, durch eine angegebene Ersetzungszeichenfolge. |
| Replace(String, String, MatchEvaluator) |
Ersetzt in einer angegebenen Eingabezeichenfolge alle Zeichenfolgen, die einem angegebenen regulären Ausdruck entsprechen, durch eine von einem MatchEvaluator Delegaten zurückgegebene Zeichenfolge. |
| Replace(String, String, Int32) |
Ersetzt in einer angegebenen Eingabezeichenfolge eine angegebene maximale Anzahl von Zeichenfolgen, die einem Muster für reguläre Ausdrücke mit einer angegebenen Ersetzungszeichenfolge entsprechen. |
| Replace(String, MatchEvaluator) |
Ersetzt in einer angegebenen Eingabezeichenfolge alle Zeichenfolgen, die einem angegebenen regulären Ausdruck entsprechen, durch eine von einem MatchEvaluator Delegaten zurückgegebene Zeichenfolge. |
| Replace(String, String) |
Ersetzt in einer angegebenen Eingabezeichenfolge alle Zeichenfolgen, die einem Muster für reguläre Ausdrücke mit einer angegebenen Ersetzungszeichenfolge entsprechen. |
| Replace(String, MatchEvaluator, Int32) |
Ersetzt in einer angegebenen Eingabezeichenfolge eine angegebene maximale Anzahl von Zeichenfolgen, die einem Muster für reguläre Ausdrücke entsprechen, durch eine von einem MatchEvaluator Delegaten zurückgegebene Zeichenfolge. |
Replace(String, String, String, RegexOptions)
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
Ersetzt in einer angegebenen Eingabezeichenfolge alle Zeichenfolgen, die einem angegebenen regulären Ausdruck entsprechen, durch eine angegebene Ersetzungszeichenfolge. Angegebene Optionen ändern den Abgleichsvorgang.
public:
static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::String ^ replacement, System::Text::RegularExpressions::RegexOptions options);
public static string Replace(string input, string pattern, string replacement, System.Text.RegularExpressions.RegexOptions options);
static member Replace : string * string * string * System.Text.RegularExpressions.RegexOptions -> string
Public Shared Function Replace (input As String, pattern As String, replacement As String, options As RegexOptions) As String
Parameter
- input
- String
Die Zeichenfolge, die nach einer Übereinstimmung gesucht werden soll.
- pattern
- String
Das muster des regulären Ausdrucks, das übereinstimmen soll.
- replacement
- String
Die Ersatzzeichenfolge.
- options
- RegexOptions
Eine bitweise Kombination der Enumerationswerte, die Optionen für den Abgleich bereitstellen.
Gibt zurück
Eine neue Zeichenfolge, die mit der Eingabezeichenfolge identisch ist, mit der Ausnahme, dass die Ersetzungszeichenfolge die Stelle jeder übereinstimmenden Zeichenfolge ist. Wenn pattern in der aktuellen Instanz nicht übereinstimmt, gibt die Methode die aktuelle Instanz unverändert zurück.
Ausnahmen
Es ist ein Fehler beim Analysieren regulärer Ausdrücke aufgetreten.
input, patternoder replacement ist .null
options ist keine gültige bitweise Kombination von RegexOptions Werten.
Ein Timeout ist aufgetreten.
Hinweise
Die statischen Replace(String, String, String, RegexOptions) Methoden entsprechen dem Erstellen eines Regex Objekts mit dem angegebenen Muster für reguläre Ausdrücke und dem Aufrufen der Instanzmethode Replace(String, String).
Der replacement Parameter gibt die Zeichenfolge an, die jede Übereinstimmung ersetzt.input
replacement kann aus einer beliebigen Kombination aus Literaltext und Ersetzungen bestehen. Ersetzungen sind die einzigen Elemente der regulären Ausdruckssprache, die in einem Ersetzungsmuster erkannt werden.
Da die Methode unverändert zurückgegeben wird, wenn keine Übereinstimmung vorhanden input ist, können Sie mit der ReferenceEquals(Object, Object) Methode ermitteln, ob die Methode ersatzweise vorgenommen wurde.
Wenn Sie für den RightToLeft Parameter angebenoptions, beginnt die Suche nach Übereinstimmungen am Ende der Eingabezeichenfolge und wird nach links verschoben. Andernfalls beginnt die Suche am Anfang der Eingabezeichenfolge und wird nach rechts verschoben.
Hinweise für Aufrufer
Diese Methode timeout nach einem Intervall, das dem Standardtimeoutwert der Anwendungsdomäne entspricht, in der sie aufgerufen wird. Wenn kein Timeoutwert für die Anwendungsdomäne definiert wurde, wird der Wert InfiniteMatchTimeoutverwendet, der die Zeitüberschreitung der Methode verhindert. Die empfohlene statische Methode zum Ersetzen einer Mustervergleichung ist Replace(String, String, String, RegexOptions, TimeSpan), mit der Sie das Timeoutintervall festlegen können.
Weitere Informationen
Gilt für:
Replace(String, String, String, RegexOptions, TimeSpan)
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
Ersetzt in einer angegebenen Eingabezeichenfolge alle Zeichenfolgen, die einem angegebenen regulären Ausdruck entsprechen, durch eine angegebene Ersetzungszeichenfolge. Zusätzliche Parameter geben Optionen an, die den Abgleichsvorgang und ein Timeoutintervall ändern, wenn keine Übereinstimmung gefunden wird.
public:
static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::String ^ replacement, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);
public static string Replace(string input, string pattern, string replacement, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);
static member Replace : string * string * string * System.Text.RegularExpressions.RegexOptions * TimeSpan -> string
Public Shared Function Replace (input As String, pattern As String, replacement As String, options As RegexOptions, matchTimeout As TimeSpan) As String
Parameter
- input
- String
Die Zeichenfolge, die nach einer Übereinstimmung gesucht werden soll.
- pattern
- String
Das muster des regulären Ausdrucks, das übereinstimmen soll.
- replacement
- String
Die Ersatzzeichenfolge.
- options
- RegexOptions
Eine bitweise Kombination der Enumerationswerte, die Optionen für den Abgleich bereitstellen.
- matchTimeout
- TimeSpan
Ein Timeoutintervall oder InfiniteMatchTimeout um anzugeben, dass die Methode kein Timeout ausführen soll.
Gibt zurück
Eine neue Zeichenfolge, die mit der Eingabezeichenfolge identisch ist, mit der Ausnahme, dass die Ersetzungszeichenfolge die Stelle jeder übereinstimmenden Zeichenfolge ist. Wenn pattern in der aktuellen Instanz nicht übereinstimmt, gibt die Methode die aktuelle Instanz unverändert zurück.
Ausnahmen
Es ist ein Fehler beim Analysieren regulärer Ausdrücke aufgetreten.
input, patternoder replacement ist .null
options ist keine gültige bitweise Kombination von RegexOptions Werten.
-oder- matchTimeout ist negativ, null oder größer als etwa 24 Tage.
Ein Timeout ist aufgetreten.
Hinweise
Die statischen Replace(String, String, String, RegexOptions, TimeSpan) Methoden entsprechen dem Erstellen eines Regex Objekts mit dem angegebenen Muster für reguläre Ausdrücke und dem Aufrufen der Instanzmethode Replace(String, String).
Der replacement Parameter gibt die Zeichenfolge an, die jede Übereinstimmung ersetzt.input
replacement kann aus einer beliebigen Kombination aus Literaltext und Ersetzungen bestehen. Ersetzungen sind die einzigen Elemente der regulären Ausdruckssprache, die in einem Ersetzungsmuster erkannt werden.
Da die Methode unverändert zurückgegeben wird, wenn keine Übereinstimmung vorhanden input ist, können Sie mit der ReferenceEquals(Object, Object) Methode ermitteln, ob die Methode ersatzweise vorgenommen wurde.
Wenn Sie für den RightToLeft Parameter angebenoptions, beginnt die Suche nach Übereinstimmungen am Ende der Eingabezeichenfolge und wird nach links verschoben. Andernfalls beginnt die Suche am Anfang der Eingabezeichenfolge und wird nach rechts verschoben.
Der matchTimeout Parameter gibt an, wie lange eine Musterabgleichsmethode versuchen soll, eine Übereinstimmung zu finden, bevor ein Zeitüberschreitungen auftreten. Das Festlegen eines Timeoutintervalls verhindert, dass reguläre Ausdrücke, die auf übermäßigem Rückverfolgungsvorgang basieren, nicht mehr reagieren, wenn sie Eingaben verarbeiten, die nahezu Übereinstimmungen enthalten.
matchTimeout überschreibt jeden Standardtimeoutwert, der für die Anwendungsdomäne definiert ist, in der die Methode ausgeführt wird.
Hinweise für Aufrufer
Es wird empfohlen, den matchTimeout Parameter auf einen geeigneten Wert festzulegen, z. B. zwei Sekunden. Wenn Sie Timeouts durch Angeben InfiniteMatchTimeoutdeaktivieren, bietet das Modul für reguläre Ausdrücke etwas bessere Leistung. Sie sollten Timeouts jedoch nur unter den folgenden Bedingungen deaktivieren:
Wenn die von einem regulären Ausdruck verarbeitete Eingabe von einer bekannten und vertrauenswürdigen Quelle abgeleitet wird oder aus statischem Text besteht. Dadurch wird Text ausgeschlossen, der dynamisch von Benutzern eingegeben wurde.
Wenn das Muster für reguläre Ausdrücke gründlich getestet wurde, um sicherzustellen, dass es Übereinstimmungen, Nicht-Übereinstimmungen und nahe Übereinstimmungen effizient verarbeitet.
Wenn das Muster für reguläre Ausdrücke keine Sprachelemente enthält, die bekanntermaßen zu übermäßigem Rückverfolgungsverhalten bei der Verarbeitung einer Nahübereinstimmung führen.
Weitere Informationen
- RegexOptions
- Ersetzungen in regulären Ausdrücken
- Elemente der Sprache für reguläre Ausdrücke
- Zurückverfolgung in regulären Ausdrücken
- Bewährte Methoden für reguläre Ausdrücke in .NET
Gilt für:
Replace(String, MatchEvaluator, Int32, Int32)
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
Ersetzt in einer angegebenen Eingabeunterzeichenfolge eine angegebene maximale Anzahl von Zeichenfolgen, die einem Muster für reguläre Ausdrücke entsprechen, durch eine von einem MatchEvaluator Delegaten zurückgegebene Zeichenfolge.
public:
System::String ^ Replace(System::String ^ input, System::Text::RegularExpressions::MatchEvaluator ^ evaluator, int count, int startat);
public string Replace(string input, System.Text.RegularExpressions.MatchEvaluator evaluator, int count, int startat);
member this.Replace : string * System.Text.RegularExpressions.MatchEvaluator * int * int -> string
Public Function Replace (input As String, evaluator As MatchEvaluator, count As Integer, startat As Integer) As String
Parameter
- input
- String
Die Zeichenfolge, die nach einer Übereinstimmung gesucht werden soll.
- evaluator
- MatchEvaluator
Eine benutzerdefinierte Methode, die jede Übereinstimmung untersucht und entweder die ursprüngliche übereinstimmende Zeichenfolge oder eine Ersetzungszeichenfolge zurückgibt.
- count
- Int32
Die maximale Anzahl der Vorkommen des Ersatzes.
- startat
- Int32
Die Zeichenposition in der Eingabezeichenfolge, an der die Suche beginnt.
Gibt zurück
Eine neue Zeichenfolge, die mit der Eingabezeichenfolge identisch ist, mit der Ausnahme, dass eine Ersetzungszeichenfolge anstelle jeder übereinstimmenden Zeichenfolge verwendet wird. Wenn das Muster für reguläre Ausdrücke in der aktuellen Instanz nicht übereinstimmt, gibt die Methode die aktuelle Instanz unverändert zurück.
Ausnahmen
input oder evaluator ist null.
startat ist kleiner als Null oder größer als die Länge von input.
Ein Timeout ist aufgetreten.
Hinweise
Weitere Informationen finden startatSie im Abschnitt "Hinweise" von Match(String, Int32).
Die Methode übergibt die ersten countMatch Objekte an den evaluator Delegaten.
Weitere Informationen
Gilt für:
Replace(String, String, MatchEvaluator, RegexOptions)
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
Ersetzt in einer angegebenen Eingabezeichenfolge alle Zeichenfolgen, die einem angegebenen regulären Ausdruck entsprechen, durch eine von einem MatchEvaluator Delegaten zurückgegebene Zeichenfolge. Angegebene Optionen ändern den Abgleichsvorgang.
public:
static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::MatchEvaluator ^ evaluator, System::Text::RegularExpressions::RegexOptions options);
public static string Replace(string input, string pattern, System.Text.RegularExpressions.MatchEvaluator evaluator, System.Text.RegularExpressions.RegexOptions options);
static member Replace : string * string * System.Text.RegularExpressions.MatchEvaluator * System.Text.RegularExpressions.RegexOptions -> string
Public Shared Function Replace (input As String, pattern As String, evaluator As MatchEvaluator, options As RegexOptions) As String
Parameter
- input
- String
Die Zeichenfolge, die nach einer Übereinstimmung gesucht werden soll.
- pattern
- String
Das muster des regulären Ausdrucks, das übereinstimmen soll.
- evaluator
- MatchEvaluator
Eine benutzerdefinierte Methode, die jede Übereinstimmung untersucht und entweder die ursprüngliche übereinstimmende Zeichenfolge oder eine Ersetzungszeichenfolge zurückgibt.
- options
- RegexOptions
Eine bitweise Kombination der Enumerationswerte, die Optionen für den Abgleich bereitstellen.
Gibt zurück
Eine neue Zeichenfolge, die mit der Eingabezeichenfolge identisch ist, mit der Ausnahme, dass eine Ersetzungszeichenfolge anstelle jeder übereinstimmenden Zeichenfolge verwendet wird. Wenn pattern in der aktuellen Instanz nicht übereinstimmt, gibt die Methode die aktuelle Instanz unverändert zurück.
Ausnahmen
Es ist ein Fehler beim Analysieren regulärer Ausdrücke aufgetreten.
input, patternoder evaluator ist .null
options ist keine gültige bitweise Kombination von RegexOptions Werten.
Ein Timeout ist aufgetreten.
Hinweise
Diese Methode ist nützlich, um eine Übereinstimmung mit regulären Ausdrücken zu ersetzen, wenn eine der folgenden Bedingungen zutrifft: Die Ersetzungszeichenfolge kann nicht leicht durch ein Ersatzmuster für reguläre Ausdrücke angegeben werden, die Ersetzungszeichenfolge ergibt sich aus der Verarbeitung der übereinstimmenden Zeichenfolge oder der Ersetzungszeichenfolge aus der bedingten Verarbeitung.
Die Methode entspricht dem Aufrufen der Matches(String, String) Methode und dem Übergeben jedes Match Objekts in der evaluator zurückgegebenen MatchCollection Stellvertretung.
Da die Methode unverändert zurückgegeben wird, wenn keine Übereinstimmung vorhanden input ist, können Sie mit der ReferenceEquals(Object, Object) Methode ermitteln, ob die Methode ersatzweise vorgenommen wurde.
Wenn Sie für den RightToLeft Parameter angebenoptions, beginnt die Suche nach Übereinstimmungen am Ende der Eingabezeichenfolge und wird nach links verschoben. Andernfalls beginnt die Suche am Anfang der Eingabezeichenfolge und wird nach rechts verschoben.
Weitere Informationen
- MatchEvaluator
- RegexOptions
- Ersetzungen in regulären Ausdrücken
- Elemente der Sprache für reguläre Ausdrücke
Gilt für:
Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan)
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
Ersetzt in einer angegebenen Eingabezeichenfolge alle Teilzeichenfolgen, die einem angegebenen regulären Ausdruck entsprechen, durch eine von einem MatchEvaluator Delegaten zurückgegebene Zeichenfolge. Zusätzliche Parameter geben Optionen an, die den Abgleichsvorgang und ein Timeoutintervall ändern, wenn keine Übereinstimmung gefunden wird.
public:
static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::MatchEvaluator ^ evaluator, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);
public static string Replace(string input, string pattern, System.Text.RegularExpressions.MatchEvaluator evaluator, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);
static member Replace : string * string * System.Text.RegularExpressions.MatchEvaluator * System.Text.RegularExpressions.RegexOptions * TimeSpan -> string
Public Shared Function Replace (input As String, pattern As String, evaluator As MatchEvaluator, options As RegexOptions, matchTimeout As TimeSpan) As String
Parameter
- input
- String
Die Zeichenfolge, die nach einer Übereinstimmung gesucht werden soll.
- pattern
- String
Das muster des regulären Ausdrucks, das übereinstimmen soll.
- evaluator
- MatchEvaluator
Eine benutzerdefinierte Methode, die jede Übereinstimmung untersucht und entweder die ursprüngliche übereinstimmende Zeichenfolge oder eine Ersetzungszeichenfolge zurückgibt.
- options
- RegexOptions
Eine bitweise Kombination der Enumerationswerte, die Optionen für den Abgleich bereitstellen.
- matchTimeout
- TimeSpan
Ein Timeoutintervall oder InfiniteMatchTimeout um anzugeben, dass die Methode kein Timeout ausführen soll.
Gibt zurück
Eine neue Zeichenfolge, die mit der Eingabezeichenfolge identisch ist, mit der Ausnahme, dass eine Ersetzungszeichenfolge anstelle jeder übereinstimmenden Zeichenfolge verwendet wird. Wenn pattern in der aktuellen Instanz nicht übereinstimmt, gibt die Methode die aktuelle Instanz unverändert zurück.
Ausnahmen
Es ist ein Fehler beim Analysieren regulärer Ausdrücke aufgetreten.
input, patternoder evaluator ist .null
options ist keine gültige bitweise Kombination von RegexOptions Werten.
-oder- matchTimeout ist negativ, null oder größer als etwa 24 Tage.
Ein Timeout ist aufgetreten.
Hinweise
Diese Methode ist nützlich, um eine Übereinstimmung mit regulären Ausdrücken zu ersetzen, wenn eine der folgenden Bedingungen zutrifft: Die Ersetzungszeichenfolge kann nicht leicht durch ein Ersatzmuster für reguläre Ausdrücke angegeben werden, die Ersetzungszeichenfolge ergibt sich aus der Verarbeitung der übereinstimmenden Zeichenfolge oder der Ersetzungszeichenfolge aus der bedingten Verarbeitung.
Die Methode entspricht dem Aufrufen der Matches(String, String) Methode und dem Übergeben jedes Match Objekts in der evaluator zurückgegebenen MatchCollection Stellvertretung.
Da die Methode unverändert zurückgegeben wird, wenn keine Übereinstimmung vorhanden input ist, können Sie mit der ReferenceEquals(Object, Object) Methode ermitteln, ob die Methode ersatzweise vorgenommen wurde.
Wenn Sie für den RightToLeft Parameter angebenoptions, beginnt die Suche nach Übereinstimmungen am Ende der Eingabezeichenfolge und wird nach links verschoben. Andernfalls beginnt die Suche am Anfang der Eingabezeichenfolge und wird nach rechts verschoben.
Der matchTimeout Parameter gibt an, wie lange eine Musterabgleichsmethode versuchen soll, eine Übereinstimmung zu finden, bevor ein Timeout ausgeht. matchTimeout Überschreibt jeden Standardtimeoutwert, der für die Anwendungsdomäne definiert ist, in der die Methode ausgeführt wird.
Hinweise für Aufrufer
Es wird empfohlen, den matchTimeout Parameter auf einen geeigneten Wert festzulegen, z. B. zwei Sekunden. Wenn Sie Timeouts durch Angeben InfiniteMatchTimeoutdeaktivieren, bietet das Modul für reguläre Ausdrücke etwas bessere Leistung. Sie sollten Timeouts jedoch nur unter den folgenden Bedingungen deaktivieren:
Wenn die von einem regulären Ausdruck verarbeitete Eingabe von einer bekannten und vertrauenswürdigen Quelle abgeleitet wird oder aus statischem Text besteht. Dadurch wird Text ausgeschlossen, der dynamisch von Benutzern eingegeben wurde.
Wenn das Muster für reguläre Ausdrücke gründlich getestet wurde, um sicherzustellen, dass es Übereinstimmungen, Nicht-Übereinstimmungen und nahe Übereinstimmungen effizient verarbeitet.
Wenn das Muster für reguläre Ausdrücke keine Sprachelemente enthält, die bekanntermaßen zu übermäßigem Rückverfolgungsverhalten bei der Verarbeitung einer Nahübereinstimmung führen.
Weitere Informationen
- RegexOptions
- Ersetzungen in regulären Ausdrücken
- Elemente der Sprache für reguläre Ausdrücke
- Zurückverfolgung in regulären Ausdrücken
- Bewährte Methoden für reguläre Ausdrücke in .NET
Gilt für:
Replace(String, String, Int32, Int32)
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
Ersetzt in einer angegebenen Eingabeunterzeichenfolge eine angegebene maximale Anzahl von Zeichenfolgen, die einem Muster für reguläre Ausdrücke mit einer angegebenen Ersetzungszeichenfolge entsprechen.
public:
System::String ^ Replace(System::String ^ input, System::String ^ replacement, int count, int startat);
public string Replace(string input, string replacement, int count, int startat);
member this.Replace : string * string * int * int -> string
Public Function Replace (input As String, replacement As String, count As Integer, startat As Integer) As String
Parameter
- input
- String
Die Zeichenfolge, die nach einer Übereinstimmung gesucht werden soll.
- replacement
- String
Die Ersatzzeichenfolge.
- count
- Int32
Die maximale Anzahl der Vorkommen des Ersatzes.
- startat
- Int32
Die Zeichenposition in der Eingabezeichenfolge, an der die Suche beginnt.
Gibt zurück
Eine neue Zeichenfolge, die mit der Eingabezeichenfolge identisch ist, mit der Ausnahme, dass die Ersetzungszeichenfolge die Stelle jeder übereinstimmenden Zeichenfolge ist. Wenn das Muster für reguläre Ausdrücke in der aktuellen Instanz nicht übereinstimmt, gibt die Methode die aktuelle Instanz unverändert zurück.
Ausnahmen
input oder replacement ist null.
startat ist kleiner als Null oder größer als die Länge von input.
Ein Timeout ist aufgetreten.
Hinweise
Weitere Informationen finden startatSie im Abschnitt "Hinweise" von Match(String, Int32).
Der replacement Parameter gibt die Zeichenfolge an, die jede Übereinstimmung ersetzt und Ersetzungen unterstützt.
Wenn count dies negativ ist, werden die Ersetzungen bis zum Ende der Zeichenfolge fortgesetzt.
Weitere Informationen
Gilt für:
Replace(String, String, String)
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
Ersetzt in einer angegebenen Eingabezeichenfolge alle Zeichenfolgen, die mit einem angegebenen Muster für reguläre Ausdrücke übereinstimmen, durch eine angegebene Ersetzungszeichenfolge.
public:
static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::String ^ replacement);
public static string Replace(string input, string pattern, string replacement);
static member Replace : string * string * string -> string
Public Shared Function Replace (input As String, pattern As String, replacement As String) As String
Parameter
- input
- String
Die Zeichenfolge, die nach einer Übereinstimmung gesucht werden soll.
- pattern
- String
Das muster des regulären Ausdrucks, das übereinstimmen soll.
- replacement
- String
Die Ersatzzeichenfolge.
Gibt zurück
Eine neue Zeichenfolge, die mit der Eingabezeichenfolge identisch ist, mit der Ausnahme, dass die Ersetzungszeichenfolge die Stelle jeder übereinstimmenden Zeichenfolge ist. Wenn pattern in der aktuellen Instanz nicht übereinstimmt, gibt die Methode die aktuelle Instanz unverändert zurück.
Ausnahmen
Es ist ein Fehler beim Analysieren regulärer Ausdrücke aufgetreten.
input, patternoder replacement ist .null
Ein Timeout ist aufgetreten.
Hinweise
Die statischen Replace(String, String, String) Methoden entsprechen dem Erstellen eines Regex Objekts mit dem angegebenen Muster für reguläre Ausdrücke und dem Aufrufen der Instanzmethode Replace(String, String).
Der replacement Parameter gibt die Zeichenfolge an, die jede Übereinstimmung ersetzt.input
replacement kann aus einer beliebigen Kombination aus Literaltext und Ersetzungen bestehen. Ersetzungen sind die einzigen Elemente der regulären Ausdruckssprache, die in einem Ersetzungsmuster erkannt werden.
Da die Methode unverändert zurückgegeben wird, wenn keine Übereinstimmung vorhanden input ist, können Sie mit der ReferenceEquals(Object, Object) Methode ermitteln, ob die Methode ersatzweise vorgenommen wurde.
Hinweise für Aufrufer
Diese Methode timeout nach einem Intervall, das dem Standardtimeoutwert der Anwendungsdomäne entspricht, in der sie aufgerufen wird. Wenn kein Timeoutwert für die Anwendungsdomäne definiert wurde, wird der Wert InfiniteMatchTimeoutverwendet, der die Zeitüberschreitung der Methode verhindert. Die empfohlene statische Methode zum Ersetzen einer Mustervergleichung ist Replace(String, String, String, RegexOptions, TimeSpan), mit der Sie das Timeoutintervall festlegen können.
Weitere Informationen
Gilt für:
Replace(String, String, MatchEvaluator)
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
Ersetzt in einer angegebenen Eingabezeichenfolge alle Zeichenfolgen, die einem angegebenen regulären Ausdruck entsprechen, durch eine von einem MatchEvaluator Delegaten zurückgegebene Zeichenfolge.
public:
static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::MatchEvaluator ^ evaluator);
public static string Replace(string input, string pattern, System.Text.RegularExpressions.MatchEvaluator evaluator);
static member Replace : string * string * System.Text.RegularExpressions.MatchEvaluator -> string
Public Shared Function Replace (input As String, pattern As String, evaluator As MatchEvaluator) As String
Parameter
- input
- String
Die Zeichenfolge, die nach einer Übereinstimmung gesucht werden soll.
- pattern
- String
Das muster des regulären Ausdrucks, das übereinstimmen soll.
- evaluator
- MatchEvaluator
Eine benutzerdefinierte Methode, die jede Übereinstimmung untersucht und entweder die ursprüngliche übereinstimmende Zeichenfolge oder eine Ersetzungszeichenfolge zurückgibt.
Gibt zurück
Eine neue Zeichenfolge, die mit der Eingabezeichenfolge identisch ist, mit der Ausnahme, dass eine Ersetzungszeichenfolge anstelle jeder übereinstimmenden Zeichenfolge verwendet wird. Wenn pattern in der aktuellen Instanz nicht übereinstimmt, gibt die Methode die aktuelle Instanz unverändert zurück.
Ausnahmen
Es ist ein Fehler beim Analysieren regulärer Ausdrücke aufgetreten.
input, patternoder evaluator ist .null
Ein Timeout ist aufgetreten.
Hinweise
Diese Methode ist nützlich, um eine Übereinstimmung mit regulären Ausdrücken zu ersetzen, wenn eine der folgenden Bedingungen zutrifft: Die Ersetzungszeichenfolge kann nicht leicht durch ein Ersatzmuster für reguläre Ausdrücke angegeben werden, die Ersetzungszeichenfolge ergibt sich aus der Verarbeitung der übereinstimmenden Zeichenfolge oder der Ersetzungszeichenfolge aus der bedingten Verarbeitung.
Die Methode entspricht dem Aufrufen der Matches(String, String) Methode und dem Übergeben jedes Match Objekts in der evaluator zurückgegebenen MatchCollection Stellvertretung.
Da die Methode unverändert zurückgegeben wird, wenn keine Übereinstimmung vorhanden input ist, können Sie mit der ReferenceEquals(Object, Object) Methode ermitteln, ob die Methode ersatzweise vorgenommen wurde.
Hinweise für Aufrufer
Diese Methode timeout nach einem Intervall, das dem Standardtimeoutwert der Anwendungsdomäne entspricht, in der sie aufgerufen wird. Wenn kein Timeoutwert für die Anwendungsdomäne definiert wurde, wird der Wert InfiniteMatchTimeoutverwendet, der die Zeitüberschreitung der Methode verhindert. Die empfohlene statische Methode zum Auswerten und Ersetzen einer Mustervergleichung ist Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan), mit der Sie das Timeoutintervall festlegen können.
Weitere Informationen
Gilt für:
Replace(String, String, Int32)
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
Ersetzt in einer angegebenen Eingabezeichenfolge eine angegebene maximale Anzahl von Zeichenfolgen, die einem Muster für reguläre Ausdrücke mit einer angegebenen Ersetzungszeichenfolge entsprechen.
public:
System::String ^ Replace(System::String ^ input, System::String ^ replacement, int count);
public string Replace(string input, string replacement, int count);
member this.Replace : string * string * int -> string
Public Function Replace (input As String, replacement As String, count As Integer) As String
Parameter
- input
- String
Die Zeichenfolge, die nach einer Übereinstimmung gesucht werden soll.
- replacement
- String
Die Ersatzzeichenfolge.
- count
- Int32
Die maximale Anzahl der Vorkommen des Ersatzes.
Gibt zurück
Eine neue Zeichenfolge, die mit der Eingabezeichenfolge identisch ist, mit der Ausnahme, dass die Ersetzungszeichenfolge die Stelle jeder übereinstimmenden Zeichenfolge ist. Wenn das Muster für reguläre Ausdrücke in der aktuellen Instanz nicht übereinstimmt, gibt die Methode die aktuelle Instanz unverändert zurück.
Ausnahmen
input oder replacement ist null.
Ein Timeout ist aufgetreten.
Hinweise
Die Suche beginnt am Anfang der input Zeichenfolge. Der replacement Parameter gibt die Zeichenfolge an, die jede Übereinstimmung ersetzt und Ersetzungen unterstützt.
Wenn count dies negativ ist, werden die Ersetzungen bis zum Ende der Zeichenfolge fortgesetzt.
Da die Methode unverändert zurückgegeben wird, wenn keine Übereinstimmung vorhanden input ist, können Sie mit der ReferenceEquals(Object, Object) Methode ermitteln, ob die Methode ersatzweise vorgenommen wurde.
Weitere Informationen
Gilt für:
Replace(String, MatchEvaluator)
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
Ersetzt in einer angegebenen Eingabezeichenfolge alle Zeichenfolgen, die einem angegebenen regulären Ausdruck entsprechen, durch eine von einem MatchEvaluator Delegaten zurückgegebene Zeichenfolge.
public:
System::String ^ Replace(System::String ^ input, System::Text::RegularExpressions::MatchEvaluator ^ evaluator);
public string Replace(string input, System.Text.RegularExpressions.MatchEvaluator evaluator);
member this.Replace : string * System.Text.RegularExpressions.MatchEvaluator -> string
Public Function Replace (input As String, evaluator As MatchEvaluator) As String
Parameter
- input
- String
Die Zeichenfolge, die nach einer Übereinstimmung gesucht werden soll.
- evaluator
- MatchEvaluator
Eine benutzerdefinierte Methode, die jede Übereinstimmung untersucht und entweder die ursprüngliche übereinstimmende Zeichenfolge oder eine Ersetzungszeichenfolge zurückgibt.
Gibt zurück
Eine neue Zeichenfolge, die mit der Eingabezeichenfolge identisch ist, mit der Ausnahme, dass eine Ersetzungszeichenfolge anstelle jeder übereinstimmenden Zeichenfolge verwendet wird. Wenn das Muster für reguläre Ausdrücke in der aktuellen Instanz nicht übereinstimmt, gibt die Methode die aktuelle Instanz unverändert zurück.
Ausnahmen
input oder evaluator ist null.
Ein Timeout ist aufgetreten.
Hinweise
Diese Methode ist nützlich, um eine Übereinstimmung mit regulären Ausdrücken zu ersetzen, wenn eine der folgenden Bedingungen zutrifft: Die Ersetzungszeichenfolge kann nicht leicht durch ein Ersatzmuster für reguläre Ausdrücke angegeben werden, die Ersetzungszeichenfolge ergibt sich aus der Verarbeitung der übereinstimmenden Zeichenfolge oder der Ersetzungszeichenfolge aus der bedingten Verarbeitung.
Die Methode entspricht dem Aufrufen der Matches(String) Methode und dem Übergeben jedes Match Objekts in der evaluator zurückgegebenen MatchCollection Stellvertretung.
Da die Methode unverändert zurückgegeben wird, wenn keine Übereinstimmung vorhanden input ist, können Sie mit der ReferenceEquals(Object, Object) Methode ermitteln, ob die Methode ersatzweise vorgenommen wurde.
Weitere Informationen
Gilt für:
Replace(String, String)
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
Ersetzt in einer angegebenen Eingabezeichenfolge alle Zeichenfolgen, die einem Muster für reguläre Ausdrücke mit einer angegebenen Ersetzungszeichenfolge entsprechen.
public:
System::String ^ Replace(System::String ^ input, System::String ^ replacement);
public string Replace(string input, string replacement);
member this.Replace : string * string -> string
Public Function Replace (input As String, replacement As String) As String
Parameter
- input
- String
Die Zeichenfolge, die nach einer Übereinstimmung gesucht werden soll.
- replacement
- String
Die Ersatzzeichenfolge.
Gibt zurück
Eine neue Zeichenfolge, die mit der Eingabezeichenfolge identisch ist, mit der Ausnahme, dass die Ersetzungszeichenfolge die Stelle jeder übereinstimmenden Zeichenfolge ist. Wenn das Muster für reguläre Ausdrücke in der aktuellen Instanz nicht übereinstimmt, gibt die Methode die aktuelle Instanz unverändert zurück.
Ausnahmen
input oder replacement ist null.
Ein Timeout ist aufgetreten.
Hinweise
Die Suche nach dem Muster beginnt am Anfang der input Zeichenfolge.
Der replacement Parameter gibt die Zeichenfolge an, die jede Übereinstimmung ersetzt.
replacement kann aus einer beliebigen Kombination aus Literaltext und Ersetzungen bestehen. Ersetzungen sind die einzigen Elemente der regulären Ausdruckssprache, die in einem Ersetzungsmuster erkannt werden.
Da die Methode unverändert zurückgegeben wird, wenn keine Übereinstimmung vorhanden input ist, können Sie mit der ReferenceEquals(Object, Object) Methode ermitteln, ob die Methode ersatzweise vorgenommen wurde.
Weitere Informationen
Gilt für:
Replace(String, MatchEvaluator, Int32)
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
- Quelle:
- Regex.Replace.cs
Ersetzt in einer angegebenen Eingabezeichenfolge eine angegebene maximale Anzahl von Zeichenfolgen, die einem Muster für reguläre Ausdrücke entsprechen, durch eine von einem MatchEvaluator Delegaten zurückgegebene Zeichenfolge.
public:
System::String ^ Replace(System::String ^ input, System::Text::RegularExpressions::MatchEvaluator ^ evaluator, int count);
public string Replace(string input, System.Text.RegularExpressions.MatchEvaluator evaluator, int count);
member this.Replace : string * System.Text.RegularExpressions.MatchEvaluator * int -> string
Public Function Replace (input As String, evaluator As MatchEvaluator, count As Integer) As String
Parameter
- input
- String
Die Zeichenfolge, die nach einer Übereinstimmung gesucht werden soll.
- evaluator
- MatchEvaluator
Eine benutzerdefinierte Methode, die jede Übereinstimmung untersucht und entweder die ursprüngliche übereinstimmende Zeichenfolge oder eine Ersetzungszeichenfolge zurückgibt.
- count
- Int32
Die maximale Anzahl der Vorkommen des Ersatzes.
Gibt zurück
Eine neue Zeichenfolge, die mit der Eingabezeichenfolge identisch ist, mit der Ausnahme, dass eine Ersetzungszeichenfolge anstelle jeder übereinstimmenden Zeichenfolge verwendet wird. Wenn das Muster für reguläre Ausdrücke in der aktuellen Instanz nicht übereinstimmt, gibt die Methode die aktuelle Instanz unverändert zurück.
Ausnahmen
input oder evaluator ist null.
Ein Timeout ist aufgetreten.
Hinweise
Diese Methode ist nützlich, um eine Übereinstimmung mit regulären Ausdrücken zu ersetzen, wenn eine der folgenden Bedingungen zutrifft: Die Ersetzungszeichenfolge kann nicht leicht durch ein Ersatzmuster für reguläre Ausdrücke angegeben werden, die Ersetzungszeichenfolge ergibt sich aus der Verarbeitung der übereinstimmenden Zeichenfolge oder der Ersetzungszeichenfolge aus der bedingten Verarbeitung.
Die Methode entspricht dem Aufrufen der Matches(String) Methode und dem Übergeben der ersten countMatch Objekte in der evaluator zurückgegebenen MatchCollection Stellvertretung.
Wenn count dies negativ ist, werden die Ersetzungen bis zum Ende der Zeichenfolge fortgesetzt.
Da die Methode unverändert zurückgegeben wird, wenn keine Übereinstimmung vorhanden input ist, können Sie mit der ReferenceEquals(Object, Object) Methode ermitteln, ob die Methode ersatzweise vorgenommen wurde.