Regex.IsMatch 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.
Gibt an, ob der reguläre Ausdruck eine Übereinstimmung in der Eingabezeichenfolge findet.
Überlädt
| Name | Beschreibung |
|---|---|
| IsMatch(String, String, RegexOptions, TimeSpan) |
Gibt an, ob der angegebene reguläre Ausdruck eine Übereinstimmung in der angegebenen Eingabezeichenfolge mithilfe der angegebenen Abgleichsoptionen und des Timeoutintervalls findet. |
| IsMatch(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan) |
Gibt an, ob der angegebene reguläre Ausdruck eine Übereinstimmung in der angegebenen Eingabespanne mithilfe der angegebenen Abgleichsoptionen und des Timeoutintervalls findet. |
| IsMatch(String, String, RegexOptions) |
Gibt an, ob der angegebene reguläre Ausdruck mithilfe der angegebenen Übereinstimmungsoptionen eine Übereinstimmung in der angegebenen Eingabezeichenfolge findet. |
| IsMatch(ReadOnlySpan<Char>, String, RegexOptions) |
Gibt an, ob der angegebene reguläre Ausdruck eine Übereinstimmung in der angegebenen Eingabespanne mithilfe der angegebenen Abgleichsoptionen findet. |
| IsMatch(String, String) |
Gibt an, ob der angegebene reguläre Ausdruck eine Übereinstimmung in der angegebenen Eingabezeichenfolge findet. |
| IsMatch(ReadOnlySpan<Char>, Int32) |
Gibt an, ob der im Regex Konstruktor angegebene reguläre Ausdruck eine Übereinstimmung in einer angegebenen Eingabespanne findet, beginnend an der angegebenen Position. |
| IsMatch(ReadOnlySpan<Char>, String) |
Gibt an, ob der angegebene reguläre Ausdruck eine Übereinstimmung in der angegebenen Eingabespanne findet. |
| IsMatch(String, Int32) |
Gibt an, ob der im Regex Konstruktor angegebene reguläre Ausdruck eine Übereinstimmung in der angegebenen Eingabezeichenfolge findet, beginnend mit der angegebenen Anfangsposition in der Zeichenfolge. |
| IsMatch(String) |
Gibt an, ob der im Regex Konstruktor angegebene reguläre Ausdruck eine Übereinstimmung in einer angegebenen Eingabezeichenfolge findet. |
| IsMatch(ReadOnlySpan<Char>) |
Gibt an, ob der im Regex Konstruktor angegebene reguläre Ausdruck eine Übereinstimmung in einer angegebenen Eingabespanne findet. |
IsMatch(String, String, RegexOptions, TimeSpan)
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
Gibt an, ob der angegebene reguläre Ausdruck eine Übereinstimmung in der angegebenen Eingabezeichenfolge mithilfe der angegebenen Abgleichsoptionen und des Timeoutintervalls findet.
public:
static bool IsMatch(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);public static bool IsMatch(string input, string pattern, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);static member IsMatch : string * string * System.Text.RegularExpressions.RegexOptions * TimeSpan -> boolPublic Shared Function IsMatch (input As String, pattern As String, options As RegexOptions, matchTimeout As TimeSpan) As BooleanParameter
- input
- String
Die Zeichenfolge, die nach einer Übereinstimmung gesucht werden soll.
- pattern
- String
Das muster des regulären Ausdrucks, das übereinstimmen soll.
- 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
truewenn der reguläre Ausdruck eine Übereinstimmung findet; andernfalls . false
Ausnahmen
Es ist ein Fehler beim Analysieren regulärer Ausdrücke aufgetreten.
input oder pattern ist null.
options ist kein gültiger RegexOptions Wert.
-oder- matchTimeout ist negativ, null oder größer als etwa 24 Tage.
Ein Timeout ist aufgetreten.
Hinweise
Die IsMatch(String, String, RegexOptions, TimeSpan) Methode wird in der Regel verwendet, um eine Zeichenfolge zu überprüfen oder sicherzustellen, dass eine Zeichenfolge einem bestimmten Muster entspricht, ohne diese Zeichenfolge für nachfolgende Manipulationen abzurufen. Um übereinstimmende Zeichenfolgen abzurufen, rufen Sie stattdessen die Match(String, String, RegexOptions, TimeSpan) Methode auf Matches(String, String, RegexOptions, TimeSpan) .
Die statische IsMatch(String, String, RegexOptions, TimeSpan) Methode entspricht dem Erstellen eines Regex Objekts mit dem angegebenen Muster und den angegebenen Optionen und dem Aufrufen der IsMatch(String) Instanzmethode. Das Muster wird für einen schnellen Abruf durch das Modul für reguläre Ausdrücke zwischengespeichert.
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. Wenn in diesem Zeitintervall keine Übereinstimmung gefunden wird, löst die Methode eine RegexMatchTimeoutException Ausnahme aus.
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:
IsMatch(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
Gibt an, ob der angegebene reguläre Ausdruck eine Übereinstimmung in der angegebenen Eingabespanne mithilfe der angegebenen Abgleichsoptionen und des Timeoutintervalls findet.
public:
static bool IsMatch(ReadOnlySpan<char> input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);public static bool IsMatch(ReadOnlySpan<char> input, string pattern, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);static member IsMatch : ReadOnlySpan<char> * string * System.Text.RegularExpressions.RegexOptions * TimeSpan -> boolPublic Shared Function IsMatch (input As ReadOnlySpan(Of Char), pattern As String, options As RegexOptions, matchTimeout As TimeSpan) As BooleanParameter
- input
- ReadOnlySpan<Char>
Die Spanne, um nach einer Übereinstimmung zu suchen.
- pattern
- String
Das muster des regulären Ausdrucks, das übereinstimmen soll.
- 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
truewenn der reguläre Ausdruck eine Übereinstimmung findet; andernfalls . false
Ausnahmen
Es ist ein Fehler beim Analysieren regulärer Ausdrücke aufgetreten.
pattern ist null.
Ein Timeout ist aufgetreten.
options ist kein gültiger RegexOptions Wert - oder ist matchTimeout negativ, null oder größer als etwa 24 Tage.
Gilt für:
IsMatch(String, String, RegexOptions)
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
Gibt an, ob der angegebene reguläre Ausdruck mithilfe der angegebenen Übereinstimmungsoptionen eine Übereinstimmung in der angegebenen Eingabezeichenfolge findet.
public:
static bool IsMatch(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options);public static bool IsMatch(string input, string pattern, System.Text.RegularExpressions.RegexOptions options);static member IsMatch : string * string * System.Text.RegularExpressions.RegexOptions -> boolPublic Shared Function IsMatch (input As String, pattern As String, options As RegexOptions) As BooleanParameter
- input
- String
Die Zeichenfolge, die nach einer Übereinstimmung gesucht werden soll.
- pattern
- String
Das muster des regulären Ausdrucks, das übereinstimmen soll.
- options
- RegexOptions
Eine bitweise Kombination der Enumerationswerte, die Optionen für den Abgleich bereitstellen.
Gibt zurück
truewenn der reguläre Ausdruck eine Übereinstimmung findet; andernfalls . false
Ausnahmen
Es ist ein Fehler beim Analysieren regulärer Ausdrücke aufgetreten.
input oder pattern ist null.
options ist kein gültiger RegexOptions Wert.
Ein Timeout ist aufgetreten.
Hinweise
Die IsMatch(String, String, RegexOptions) Methode wird in der Regel verwendet, um eine Zeichenfolge zu überprüfen oder sicherzustellen, dass eine Zeichenfolge einem bestimmten Muster entspricht, ohne diese Zeichenfolge für nachfolgende Manipulationen abzurufen. Um übereinstimmende Zeichenfolgen abzurufen, rufen Sie stattdessen die Match(String, String, RegexOptions) Methode auf Matches(String, String, RegexOptions) .
Die statische IsMatch(String, String, RegexOptions) Methode entspricht dem Erstellen eines Regex Objekts mit dem angegebenen Muster und den angegebenen Optionen und dem Aufrufen der IsMatch(String) Instanzmethode. Das Muster wird für einen schnellen Abruf durch das Modul für reguläre Ausdrücke zwischengespeichert.
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 Überprüfen einer Mustervergleichung ist IsMatch(String, String, RegexOptions, TimeSpan), mit der Sie das Timeoutintervall festlegen können.
Weitere Informationen
Gilt für:
IsMatch(ReadOnlySpan<Char>, String, RegexOptions)
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
Gibt an, ob der angegebene reguläre Ausdruck eine Übereinstimmung in der angegebenen Eingabespanne mithilfe der angegebenen Abgleichsoptionen findet.
public:
static bool IsMatch(ReadOnlySpan<char> input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options);public static bool IsMatch(ReadOnlySpan<char> input, string pattern, System.Text.RegularExpressions.RegexOptions options);static member IsMatch : ReadOnlySpan<char> * string * System.Text.RegularExpressions.RegexOptions -> boolPublic Shared Function IsMatch (input As ReadOnlySpan(Of Char), pattern As String, options As RegexOptions) As BooleanParameter
- input
- ReadOnlySpan<Char>
Die Spanne, um nach einer Übereinstimmung zu suchen.
- pattern
- String
Das muster des regulären Ausdrucks, das übereinstimmen soll.
- options
- RegexOptions
Eine bitweise Kombination der Enumerationswerte, die Optionen für den Abgleich bereitstellen.
Gibt zurück
truewenn der reguläre Ausdruck eine Übereinstimmung findet; andernfalls . false
Ausnahmen
Es ist ein Fehler beim Analysieren regulärer Ausdrücke aufgetreten.
pattern ist null.
Ein Timeout ist aufgetreten.
options ist kein gültiger RegexOptions Wert.
Gilt für:
IsMatch(String, String)
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
Gibt an, ob der angegebene reguläre Ausdruck eine Übereinstimmung in der angegebenen Eingabezeichenfolge findet.
public:
static bool IsMatch(System::String ^ input, System::String ^ pattern);public static bool IsMatch(string input, string pattern);static member IsMatch : string * string -> boolPublic Shared Function IsMatch (input As String, pattern As String) As BooleanParameter
- input
- String
Die Zeichenfolge, die nach einer Übereinstimmung gesucht werden soll.
- pattern
- String
Das muster des regulären Ausdrucks, das übereinstimmen soll.
Gibt zurück
truewenn der reguläre Ausdruck eine Übereinstimmung findet; andernfalls . false
Ausnahmen
Es ist ein Fehler beim Analysieren regulärer Ausdrücke aufgetreten.
input oder pattern ist null.
Ein Timeout ist aufgetreten.
Hinweise
Die IsMatch(String, String) Methode wird in der Regel verwendet, um eine Zeichenfolge zu überprüfen oder sicherzustellen, dass eine Zeichenfolge einem bestimmten Muster entspricht, ohne diese Zeichenfolge für nachfolgende Manipulationen abzurufen. Um übereinstimmende Zeichenfolgen abzurufen, rufen Sie stattdessen die Match(String, String) Methode auf Matches(String, String) .
Die statische IsMatch(String, String) Methode entspricht dem Erstellen eines Regex Objekts mit dem angegebenen Muster und dem Aufrufen der IsMatch(String) Instanzmethode. Das Muster wird für einen schnellen Abruf durch das Modul für reguläre Ausdrücke zwischengespeichert.
Hinweise für Aufrufer
Diese Methode timeout nach einem Intervall, das dem Standardtimeoutwert der Anwendungsdomäne entspricht, in der die Methode 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 Überprüfen einer Mustervergleichung ist IsMatch(String, String, RegexOptions, TimeSpan), mit der Sie das Timeoutintervall festlegen können.
Weitere Informationen
Gilt für:
IsMatch(ReadOnlySpan<Char>, Int32)
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
Gibt an, ob der im Regex Konstruktor angegebene reguläre Ausdruck eine Übereinstimmung in einer angegebenen Eingabespanne findet, beginnend an der angegebenen Position.
public:
bool IsMatch(ReadOnlySpan<char> input, int startat);public bool IsMatch(ReadOnlySpan<char> input, int startat);member this.IsMatch : ReadOnlySpan<char> * int -> boolPublic Function IsMatch (input As ReadOnlySpan(Of Char), startat As Integer) As BooleanParameter
- input
- ReadOnlySpan<Char>
Die Spanne, um nach einer Übereinstimmung zu suchen.
- startat
- Int32
Die nullbasierte Zeichenposition, an der die Suche gestartet werden soll.
Gibt zurück
truewenn der reguläre Ausdruck eine Übereinstimmung findet; andernfalls . false
Ausnahmen
Ein Timeout ist aufgetreten.
Gilt für:
IsMatch(ReadOnlySpan<Char>, String)
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
Gibt an, ob der angegebene reguläre Ausdruck eine Übereinstimmung in der angegebenen Eingabespanne findet.
public:
static bool IsMatch(ReadOnlySpan<char> input, System::String ^ pattern);public static bool IsMatch(ReadOnlySpan<char> input, string pattern);static member IsMatch : ReadOnlySpan<char> * string -> boolPublic Shared Function IsMatch (input As ReadOnlySpan(Of Char), pattern As String) As BooleanParameter
- input
- ReadOnlySpan<Char>
Die Spanne, um nach einer Übereinstimmung zu suchen.
- pattern
- String
Das muster des regulären Ausdrucks, das übereinstimmen soll.
Gibt zurück
truewenn der reguläre Ausdruck eine Übereinstimmung findet; andernfalls . false
Ausnahmen
Es ist ein Fehler beim Analysieren regulärer Ausdrücke aufgetreten.
pattern ist null.
Ein Timeout ist aufgetreten.
Gilt für:
IsMatch(String, Int32)
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
Gibt an, ob der im Regex Konstruktor angegebene reguläre Ausdruck eine Übereinstimmung in der angegebenen Eingabezeichenfolge findet, beginnend mit der angegebenen Anfangsposition in der Zeichenfolge.
public:
bool IsMatch(System::String ^ input, int startat);public bool IsMatch(string input, int startat);member this.IsMatch : string * int -> boolPublic Function IsMatch (input As String, startat As Integer) As BooleanParameter
- input
- String
Die Zeichenfolge, die nach einer Übereinstimmung gesucht werden soll.
- startat
- Int32
Die Zeichenposition, an der die Suche gestartet werden soll.
Gibt zurück
truewenn der reguläre Ausdruck eine Übereinstimmung findet; andernfalls . false
Ausnahmen
input ist null.
startat ist kleiner als Null oder größer als die Länge von input.
Ein Timeout ist aufgetreten.
Hinweise
Die IsMatch(String, Int32) Methode wird in der Regel verwendet, um eine Zeichenfolge zu überprüfen oder sicherzustellen, dass eine Zeichenfolge einem bestimmten Muster entspricht, ohne diese Zeichenfolge für nachfolgende Manipulationen abzurufen. Um übereinstimmende Zeichenfolgen abzurufen, rufen Sie stattdessen die Match(String, Int32) Methode auf Matches(String, Int32) .
Weitere Informationen finden startatSie in den Anmerkungen zu Match(String, Int32).
Weitere Informationen
Gilt für:
IsMatch(String)
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
Gibt an, ob der im Regex Konstruktor angegebene reguläre Ausdruck eine Übereinstimmung in einer angegebenen Eingabezeichenfolge findet.
public:
bool IsMatch(System::String ^ input);public bool IsMatch(string input);member this.IsMatch : string -> boolPublic Function IsMatch (input As String) As BooleanParameter
- input
- String
Die Zeichenfolge, die nach einer Übereinstimmung gesucht werden soll.
Gibt zurück
truewenn der reguläre Ausdruck eine Übereinstimmung findet; andernfalls . false
Ausnahmen
input ist null.
Ein Timeout ist aufgetreten.
Hinweise
Die IsMatch(String) Methode wird in der Regel verwendet, um eine Zeichenfolge zu überprüfen oder sicherzustellen, dass eine Zeichenfolge einem bestimmten Muster entspricht, ohne diese Zeichenfolge für nachfolgende Manipulationen abzurufen. Um zu ermitteln, ob eine oder mehrere Zeichenfolgen einem Muster für reguläre Ausdrücke entsprechen und diese für nachfolgende Manipulationen abrufen, rufen Sie die Match(String) methode auf Matches(String) .
Die RegexMatchTimeoutException Ausnahme wird ausgelöst, wenn die Ausführungszeit des Abgleichsvorgangs das vom Regex(String, RegexOptions, TimeSpan) Konstruktor angegebene Timeoutintervall überschreitet. Wenn Sie beim Aufrufen des Konstruktors kein Timeoutintervall festlegen, wird die Ausnahme ausgelöst, wenn der Vorgang einen Timeoutwert überschreitet, der für die Anwendungsdomäne festgelegt wurde, in der das Regex Objekt erstellt wird. Wenn kein Timeout im Regex Konstruktoraufruf oder in den Eigenschaften der Anwendungsdomäne definiert ist oder wenn der Timeoutwert ist InfiniteMatchTimeout, wird keine Ausnahme ausgelöst.
Weitere Informationen
Gilt für:
IsMatch(ReadOnlySpan<Char>)
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
Gibt an, ob der im Regex Konstruktor angegebene reguläre Ausdruck eine Übereinstimmung in einer angegebenen Eingabespanne findet.
public:
bool IsMatch(ReadOnlySpan<char> input);public bool IsMatch(ReadOnlySpan<char> input);member this.IsMatch : ReadOnlySpan<char> -> boolPublic Function IsMatch (input As ReadOnlySpan(Of Char)) As BooleanParameter
- input
- ReadOnlySpan<Char>
Die Spanne, um nach einer Übereinstimmung zu suchen.
Gibt zurück
truewenn der reguläre Ausdruck eine Übereinstimmung findet; andernfalls . false
Ausnahmen
Ein Timeout ist aufgetreten.
