Regex.Replace Methode

Definition

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

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

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

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.

Weitere Informationen

Gilt für: