Regex.Matches 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.
Durchsucht eine Eingabezeichenfolge nach allen Vorkommen eines regulären Ausdrucks und gibt alle Übereinstimmungen zurück.
Überlädt
| Name | Beschreibung |
|---|---|
| Matches(String, String, RegexOptions, TimeSpan) |
Durchsucht die angegebene Eingabezeichenfolge nach allen Vorkommen eines angegebenen regulären Ausdrucks unter Verwendung der angegebenen Abgleichsoptionen und des Timeoutintervalls. |
| Matches(String, String, RegexOptions) |
Durchsucht die angegebene Eingabezeichenfolge nach allen Vorkommen eines angegebenen regulären Ausdrucks mithilfe der angegebenen Abgleichsoptionen. |
| Matches(String, Int32) |
Durchsucht die angegebene Eingabezeichenfolge nach allen Vorkommen eines regulären Ausdrucks, beginnend mit der angegebenen Anfangsposition in der Zeichenfolge. |
| Matches(String) |
Durchsucht die angegebene Eingabezeichenfolge nach allen Vorkommen eines regulären Ausdrucks. |
| Matches(String, String) |
Durchsucht die angegebene Eingabezeichenfolge nach allen Vorkommen eines angegebenen regulären Ausdrucks. |
Matches(String, String, RegexOptions, TimeSpan)
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
Durchsucht die angegebene Eingabezeichenfolge nach allen Vorkommen eines angegebenen regulären Ausdrucks unter Verwendung der angegebenen Abgleichsoptionen und des Timeoutintervalls.
public:
static System::Text::RegularExpressions::MatchCollection ^ Matches(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);public static System.Text.RegularExpressions.MatchCollection Matches(string input, string pattern, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);static member Matches : string * string * System.Text.RegularExpressions.RegexOptions * TimeSpan -> System.Text.RegularExpressions.MatchCollectionPublic Shared Function Matches (input As String, pattern As String, options As RegexOptions, matchTimeout As TimeSpan) As MatchCollectionParameter
- 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 angeben.
- matchTimeout
- TimeSpan
Ein Timeoutintervall oder InfiniteMatchTimeout um anzugeben, dass die Methode kein Timeout ausführen soll.
Gibt zurück
Eine Auflistung der Objekte, die Match von der Suche gefunden wurden. Wenn keine Übereinstimmungen gefunden werden, gibt die Methode ein leeres Auflistungsobjekt zurück.
Ausnahmen
Es ist ein Fehler beim Analysieren regulärer Ausdrücke aufgetreten.
input oder pattern ist null.
options ist keine gültige bitweise Kombination von RegexOptions Werten.
-oder- matchTimeout ist negativ, null oder größer als etwa 24 Tage.
Hinweise
Die Matches(String, String, RegexOptions, TimeSpan) Methode ähnelt der Match(String, String, RegexOptions, TimeSpan) Methode, mit der Ausnahme, dass sie Informationen zu allen Übereinstimmungen zurückgibt, die in der Eingabezeichenfolge gefunden wurden, anstelle einer einzigen Übereinstimmung.
Die statischen Matches Methoden entsprechen dem Erstellen eines Regex Objekts mit dem angegebenen Muster für reguläre Ausdrücke und dem Aufrufen der Instanzmethode Matches.
Die Matches(String, String, RegexOptions, TimeSpan) Methode verwendet eine faule Auswertung, um das zurückgegebene MatchCollection Objekt aufzufüllen. Der Zugriff auf Elemente dieser Auflistung, Count z. B. und CopyTo(Array, Int32) bewirkt, dass die Auflistung sofort aufgefüllt wird. Um die Vorteile der faulen Auswertung zu nutzen, durchlaufen Sie die Sammlung mithilfe foreachvon .
Aufgrund ihrer faulen Auswertung löst Matches(String, String, RegexOptions, TimeSpan) das Aufrufen der RegexMatchTimeoutException Methode keine Ausnahme aus. Eine Ausnahme wird jedoch ausgelöst, wenn ein Vorgang für das MatchCollection von dieser Methode zurückgegebene Objekt ausgeführt wird, wenn ein Abgleichsvorgang das durch den matchTimeout Parameter angegebene Timeoutintervall überschreitet.
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:
Matches(String, String, RegexOptions)
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
Durchsucht die angegebene Eingabezeichenfolge nach allen Vorkommen eines angegebenen regulären Ausdrucks mithilfe der angegebenen Abgleichsoptionen.
public:
static System::Text::RegularExpressions::MatchCollection ^ Matches(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options);public static System.Text.RegularExpressions.MatchCollection Matches(string input, string pattern, System.Text.RegularExpressions.RegexOptions options);static member Matches : string * string * System.Text.RegularExpressions.RegexOptions -> System.Text.RegularExpressions.MatchCollectionPublic Shared Function Matches (input As String, pattern As String, options As RegexOptions) As MatchCollectionParameter
- 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 angeben.
Gibt zurück
Eine Auflistung der Objekte, die Match von der Suche gefunden wurden. Wenn keine Übereinstimmungen gefunden werden, gibt die Methode ein leeres Auflistungsobjekt zurück.
Ausnahmen
Es ist ein Fehler beim Analysieren regulärer Ausdrücke aufgetreten.
input oder pattern ist null.
options ist keine gültige bitweise Kombination von RegexOptions Werten.
Hinweise
Die Matches(String, String, RegexOptions) Methode ähnelt der Match(String, String, RegexOptions) Methode, mit der Ausnahme, dass sie Informationen zu allen Übereinstimmungen zurückgibt, die in der Eingabezeichenfolge gefunden wurden, anstelle einer einzigen Übereinstimmung.
Die statischen Matches Methoden entsprechen dem Erstellen eines Regex Objekts mit dem angegebenen Muster für reguläre Ausdrücke und dem Aufrufen der Instanzmethode Matches.
Die Matches(String, String, RegexOptions) Methode verwendet eine faule Auswertung, um das zurückgegebene MatchCollection Objekt aufzufüllen. Der Zugriff auf Elemente dieser Auflistung, Count z. B. und CopyTo(Array, Int32) bewirkt, dass die Auflistung sofort aufgefüllt wird. Um die Vorteile der faulen Auswertung zu nutzen, durchlaufen Sie die Sammlung mithilfe foreachvon .
Aufgrund ihrer faulen Auswertung löst Matches(String, String, RegexOptions) das Aufrufen der RegexMatchTimeoutException Methode keine Ausnahme aus. Die Ausnahme wird jedoch ausgelöst, wenn ein Vorgang für das MatchCollection von dieser Methode zurückgegebene Objekt ausgeführt wird, wenn ein Abgleichsvorgang das Timeoutintervall überschreitet.
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 Abrufen mehrerer Mustervergleiche ist Matches(String, String, RegexOptions, TimeSpan), mit der Sie das Timeoutintervall festlegen können.
Weitere Informationen
Gilt für:
Matches(String, Int32)
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
Durchsucht die angegebene Eingabezeichenfolge nach allen Vorkommen eines regulären Ausdrucks, beginnend mit der angegebenen Anfangsposition in der Zeichenfolge.
public:
System::Text::RegularExpressions::MatchCollection ^ Matches(System::String ^ input, int startat);public System.Text.RegularExpressions.MatchCollection Matches(string input, int startat);member this.Matches : string * int -> System.Text.RegularExpressions.MatchCollectionPublic Function Matches (input As String, startat As Integer) As MatchCollectionParameter
- input
- String
Die Zeichenfolge, die nach einer Übereinstimmung gesucht werden soll.
- startat
- Int32
Die Zeichenposition in der Eingabezeichenfolge, an der die Suche gestartet werden soll.
Gibt zurück
Eine Auflistung der Objekte, die Match von der Suche gefunden wurden. Wenn keine Übereinstimmungen gefunden werden, gibt die Methode ein leeres Auflistungsobjekt zurück.
Ausnahmen
input ist null.
startat ist kleiner als Null oder größer als die Länge von input.
Hinweise
Die Matches(String, Int32) Methode ähnelt der Match(String, Int32) Methode, mit der Ausnahme, dass sie Informationen zu allen Übereinstimmungen zurückgibt, die in der Eingabezeichenfolge gefunden wurden, anstelle einer einzigen Übereinstimmung.
Weitere Informationen finden startatSie in den Anmerkungen zu Match(String, Int32).
Die Matches(String, Int32) Methode verwendet eine faule Auswertung, um das zurückgegebene MatchCollection Objekt aufzufüllen. Der Zugriff auf Elemente dieser Auflistung, Count z. B. und CopyTo(Array, Int32) bewirkt, dass die Auflistung sofort aufgefüllt wird. Um die Vorteile der faulen Auswertung zu nutzen, durchlaufen Sie die Sammlung mithilfe foreachvon .
Aufgrund ihrer faulen Auswertung löst Matches(String, Int32) das Aufrufen der RegexMatchTimeoutException Methode keine Ausnahme aus. Die Ausnahme wird jedoch ausgelöst, wenn ein Vorgang für das MatchCollection von dieser Methode zurückgegebene Objekt ausgeführt wird, wenn die MatchTimeout Eigenschaft nicht InfiniteMatchTimeout ist und ein abgleicher Vorgang das Timeoutintervall überschreitet.
Weitere Informationen
Gilt für:
Matches(String)
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
Durchsucht die angegebene Eingabezeichenfolge nach allen Vorkommen eines regulären Ausdrucks.
public:
System::Text::RegularExpressions::MatchCollection ^ Matches(System::String ^ input);public System.Text.RegularExpressions.MatchCollection Matches(string input);member this.Matches : string -> System.Text.RegularExpressions.MatchCollectionPublic Function Matches (input As String) As MatchCollectionParameter
- input
- String
Die Zeichenfolge, die nach einer Übereinstimmung gesucht werden soll.
Gibt zurück
Eine Auflistung der Objekte, die Match von der Suche gefunden wurden. Wenn keine Übereinstimmungen gefunden werden, gibt die Methode ein leeres Auflistungsobjekt zurück.
Ausnahmen
input ist null.
Hinweise
Die Matches(String) Methode ähnelt der Match(String) Methode, mit der Ausnahme, dass sie Informationen zu allen Übereinstimmungen zurückgibt, die in der Eingabezeichenfolge gefunden wurden, anstelle einer einzigen Übereinstimmung. Die Auflistung enthält nur Übereinstimmungen und beendet bei der ersten nicht übereinstimmenden Übereinstimmung.
Die Matches(String) Methode verwendet eine faule Auswertung, um das zurückgegebene MatchCollection Objekt aufzufüllen. Der Zugriff auf Elemente dieser Auflistung, Count z. B. und CopyTo(Array, Int32) bewirkt, dass die Auflistung sofort aufgefüllt wird. Um die Vorteile der faulen Auswertung zu nutzen, durchlaufen Sie die Sammlung mithilfe foreachvon .
Aufgrund ihrer faulen Auswertung löst Matches(String) das Aufrufen der RegexMatchTimeoutException Methode keine Ausnahme aus. Die Ausnahme wird jedoch ausgelöst, wenn ein Vorgang für das MatchCollection von dieser Methode zurückgegebene Objekt ausgeführt wird, wenn die MatchTimeout Eigenschaft nicht InfiniteMatchTimeout ist und ein abgleicher Vorgang das Timeoutintervall überschreitet.
Weitere Informationen
Gilt für:
Matches(String, String)
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
- Quelle:
- Regex.Match.cs
Durchsucht die angegebene Eingabezeichenfolge nach allen Vorkommen eines angegebenen regulären Ausdrucks.
public:
static System::Text::RegularExpressions::MatchCollection ^ Matches(System::String ^ input, System::String ^ pattern);public static System.Text.RegularExpressions.MatchCollection Matches(string input, string pattern);static member Matches : string * string -> System.Text.RegularExpressions.MatchCollectionPublic Shared Function Matches (input As String, pattern As String) As MatchCollectionParameter
- 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
Eine Auflistung der Objekte, die Match von der Suche gefunden wurden. Wenn keine Übereinstimmungen gefunden werden, gibt die Methode ein leeres Auflistungsobjekt zurück.
Ausnahmen
Es ist ein Fehler beim Analysieren regulärer Ausdrücke aufgetreten.
input oder pattern ist null.
Hinweise
Die Matches(String, String) Methode ähnelt der Match(String, String) Methode, mit der Ausnahme, dass sie Informationen zu allen Übereinstimmungen zurückgibt, die in der Eingabezeichenfolge gefunden wurden, anstelle einer einzigen Übereinstimmung.
Die statischen Matches Methoden entsprechen dem Erstellen eines Regex Objekts mit dem angegebenen Muster für reguläre Ausdrücke und dem Aufrufen der Instanzmethode Matches.
Die Matches(String, String) Methode verwendet eine faule Auswertung, um das zurückgegebene MatchCollection Objekt aufzufüllen. Der Zugriff auf Elemente dieser Auflistung, Count z. B. und CopyTo(Array, Int32) bewirkt, dass die Auflistung sofort aufgefüllt wird. Um die Vorteile der faulen Auswertung zu nutzen, durchlaufen Sie die Sammlung mithilfe foreachvon .
Aufgrund ihrer faulen Auswertung löst Matches(String, String) das Aufrufen der RegexMatchTimeoutException Methode keine Ausnahme aus. Die Ausnahme wird jedoch ausgelöst, wenn ein Vorgang für das MatchCollection von dieser Methode zurückgegebene Objekt ausgeführt wird, wenn ein Abgleichsvorgang das Timeoutintervall überschreitet.
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 Abrufen mehrerer Mustervergleiche ist Matches(String, String, RegexOptions, TimeSpan), mit der Sie das Timeoutintervall angeben können.
