Regex.Matches Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Zoekt in een invoertekenreeks naar alle exemplaren van een reguliere expressie en retourneert alle overeenkomsten.
Overloads
| Name | Description |
|---|---|
| Matches(String, String, RegexOptions, TimeSpan) |
Doorzoekt de opgegeven invoertekenreeks voor alle exemplaren van een opgegeven reguliere expressie, met behulp van de opgegeven overeenkomende opties en time-outinterval. |
| Matches(String, String, RegexOptions) |
Doorzoekt de opgegeven invoertekenreeks voor alle exemplaren van een opgegeven reguliere expressie, met behulp van de opgegeven overeenkomende opties. |
| Matches(String, Int32) |
Hiermee wordt gezocht naar de opgegeven invoertekenreeks voor alle exemplaren van een reguliere expressie, te beginnen bij de opgegeven beginpositie in de tekenreeks. |
| Matches(String) |
Doorzoekt de opgegeven invoertekenreeks voor alle exemplaren van een reguliere expressie. |
| Matches(String, String) |
Hiermee wordt gezocht naar de opgegeven invoertekenreeks voor alle exemplaren van een opgegeven reguliere expressie. |
Matches(String, String, RegexOptions, TimeSpan)
- Bron:
- Regex.Match.cs
- Bron:
- Regex.Match.cs
- Bron:
- Regex.Match.cs
- Bron:
- Regex.Match.cs
- Bron:
- Regex.Match.cs
Doorzoekt de opgegeven invoertekenreeks voor alle exemplaren van een opgegeven reguliere expressie, met behulp van de opgegeven overeenkomende opties en time-outinterval.
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 MatchCollectionParameters
- input
- String
De tekenreeks om naar een overeenkomst te zoeken.
- pattern
- String
Het reguliere expressiepatroon dat moet overeenkomen.
- options
- RegexOptions
Een bitsgewijze combinatie van de opsommingswaarden waarmee opties voor overeenkomende waarden worden opgegeven.
- matchTimeout
- TimeSpan
Een time-outinterval of InfiniteMatchTimeout om aan te geven dat er geen time-out optreedt voor de methode.
Retouren
Een verzameling van de Match objecten die door de zoekopdracht zijn gevonden. Als er geen overeenkomsten worden gevonden, retourneert de methode een leeg verzamelingsobject.
Uitzonderingen
Er is een reguliere expressieparseringsfout opgetreden.
input of pattern is null.
options is geen geldige bitsgewijze combinatie van RegexOptions waarden.
-of- matchTimeout is negatief, nul of groter dan ongeveer 24 dagen.
Opmerkingen
De Matches(String, String, RegexOptions, TimeSpan) methode is vergelijkbaar met de Match(String, String, RegexOptions, TimeSpan) methode, behalve dat deze informatie retourneert over alle overeenkomsten in de invoertekenreeks, in plaats van één overeenkomst.
De statische Matches methoden zijn gelijk aan het maken van een Regex object met het opgegeven reguliere expressiepatroon en het aanroepen van de instantiemethode Matches.
De Matches(String, String, RegexOptions, TimeSpan) methode maakt gebruik van luie evaluatie om het geretourneerde MatchCollection object te vullen. Toegang tot leden van deze verzameling, zoals Count en CopyTo(Array, Int32) zorgt ervoor dat de verzameling onmiddellijk wordt ingevuld. Om te profiteren van luie evaluatie, itereert u de verzameling met behulp van foreach.
Vanwege de luie evaluatie genereert Matches(String, String, RegexOptions, TimeSpan) het aanroepen van de RegexMatchTimeoutException methode geen uitzondering. Er wordt echter een uitzondering gegenereerd wanneer een bewerking wordt uitgevoerd op het MatchCollection object dat door deze methode wordt geretourneerd, als een overeenkomende bewerking het time-outinterval overschrijdt dat is opgegeven door de matchTimeout parameter.
Notities voor bellers
U wordt aangeraden de matchTimeout parameter in te stellen op een geschikte waarde, zoals twee seconden. Als u time-outs uitschakelt door op te InfiniteMatchTimeoutgeven, biedt de reguliere expressie-engine iets betere prestaties. Schakel echter alleen time-outs uit onder de volgende voorwaarden:
Wanneer de invoer die door een reguliere expressie wordt verwerkt, wordt afgeleid van een bekende en vertrouwde bron of bestaat uit statische tekst. Dit sluit tekst uit die dynamisch door gebruikers is ingevoerd.
Wanneer het reguliere expressiepatroon grondig is getest om ervoor te zorgen dat er efficiënt overeenkomsten, niet-overeenkomsten en bijna-overeenkomsten worden verwerkt.
Wanneer het reguliere expressiepatroon geen taalelementen bevat die bekend zijn dat ze overmatige backtracking veroorzaken bij het verwerken van een bijna-overeenkomst.
Zie ook
Van toepassing op
Matches(String, String, RegexOptions)
- Bron:
- Regex.Match.cs
- Bron:
- Regex.Match.cs
- Bron:
- Regex.Match.cs
- Bron:
- Regex.Match.cs
- Bron:
- Regex.Match.cs
Doorzoekt de opgegeven invoertekenreeks voor alle exemplaren van een opgegeven reguliere expressie, met behulp van de opgegeven overeenkomende opties.
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 MatchCollectionParameters
- input
- String
De tekenreeks om naar een overeenkomst te zoeken.
- pattern
- String
Het reguliere expressiepatroon dat moet overeenkomen.
- options
- RegexOptions
Een bitsgewijze combinatie van de opsommingswaarden waarmee opties voor overeenkomende waarden worden opgegeven.
Retouren
Een verzameling van de Match objecten die door de zoekopdracht zijn gevonden. Als er geen overeenkomsten worden gevonden, retourneert de methode een leeg verzamelingsobject.
Uitzonderingen
Er is een reguliere expressieparseringsfout opgetreden.
input of pattern is null.
options is geen geldige bitsgewijze combinatie van RegexOptions waarden.
Opmerkingen
De Matches(String, String, RegexOptions) methode is vergelijkbaar met de Match(String, String, RegexOptions) methode, behalve dat deze informatie retourneert over alle overeenkomsten in de invoertekenreeks, in plaats van één overeenkomst.
De statische Matches methoden zijn gelijk aan het maken van een Regex object met het opgegeven reguliere expressiepatroon en het aanroepen van de instantiemethode Matches.
De Matches(String, String, RegexOptions) methode maakt gebruik van luie evaluatie om het geretourneerde MatchCollection object te vullen. Toegang tot leden van deze verzameling, zoals Count en CopyTo(Array, Int32) zorgt ervoor dat de verzameling onmiddellijk wordt ingevuld. Om te profiteren van luie evaluatie, itereert u de verzameling met behulp van foreach.
Vanwege de luie evaluatie genereert Matches(String, String, RegexOptions) het aanroepen van de RegexMatchTimeoutException methode geen uitzondering. De uitzondering wordt echter gegenereerd wanneer een bewerking wordt uitgevoerd op het MatchCollection object dat door deze methode wordt geretourneerd, als een overeenkomende bewerking het time-outinterval overschrijdt.
Notities voor bellers
Deze methode treedt op na een interval dat gelijk is aan de standaardtime-outwaarde van het toepassingsdomein waarin deze wordt aangeroepen. Als er geen time-outwaarde is gedefinieerd voor het toepassingsdomein, wordt de waarde InfiniteMatchTimeout, waardoor er geen time-out optreedt voor de methode, gebruikt. De aanbevolen statische methode voor het ophalen van meerdere patroonovereenkomsten is Matches(String, String, RegexOptions, TimeSpan), waarmee u het time-outinterval kunt instellen.
Zie ook
Van toepassing op
Matches(String, Int32)
- Bron:
- Regex.Match.cs
- Bron:
- Regex.Match.cs
- Bron:
- Regex.Match.cs
- Bron:
- Regex.Match.cs
- Bron:
- Regex.Match.cs
Hiermee wordt gezocht naar de opgegeven invoertekenreeks voor alle exemplaren van een reguliere expressie, te beginnen bij de opgegeven beginpositie in de tekenreeks.
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 MatchCollectionParameters
- input
- String
De tekenreeks om naar een overeenkomst te zoeken.
- startat
- Int32
De tekenpositie in de invoertekenreeks waarop de zoekopdracht moet worden gestart.
Retouren
Een verzameling van de Match objecten die door de zoekopdracht zijn gevonden. Als er geen overeenkomsten worden gevonden, retourneert de methode een leeg verzamelingsobject.
Uitzonderingen
input is null.
startat is kleiner dan nul of groter dan de lengte van input.
Opmerkingen
De Matches(String, Int32) methode is vergelijkbaar met de Match(String, Int32) methode, behalve dat deze informatie retourneert over alle overeenkomsten in de invoertekenreeks, in plaats van één overeenkomst.
Zie de opmerkingen voor Match(String, Int32)meer informatie over startat.
De Matches(String, Int32) methode maakt gebruik van luie evaluatie om het geretourneerde MatchCollection object te vullen. Toegang tot leden van deze verzameling, zoals Count en CopyTo(Array, Int32) zorgt ervoor dat de verzameling onmiddellijk wordt ingevuld. Om te profiteren van luie evaluatie, itereert u de verzameling met behulp van foreach.
Vanwege de luie evaluatie genereert Matches(String, Int32) het aanroepen van de RegexMatchTimeoutException methode geen uitzondering. De uitzondering wordt echter gegenereerd wanneer een bewerking wordt uitgevoerd op het MatchCollection object dat door deze methode wordt geretourneerd, als de MatchTimeout eigenschap niet InfiniteMatchTimeout is en een overeenkomende bewerking het time-outinterval overschrijdt.
Zie ook
Van toepassing op
Matches(String)
- Bron:
- Regex.Match.cs
- Bron:
- Regex.Match.cs
- Bron:
- Regex.Match.cs
- Bron:
- Regex.Match.cs
- Bron:
- Regex.Match.cs
Doorzoekt de opgegeven invoertekenreeks voor alle exemplaren van een reguliere expressie.
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 MatchCollectionParameters
- input
- String
De tekenreeks om naar een overeenkomst te zoeken.
Retouren
Een verzameling van de Match objecten die door de zoekopdracht zijn gevonden. Als er geen overeenkomsten worden gevonden, retourneert de methode een leeg verzamelingsobject.
Uitzonderingen
input is null.
Opmerkingen
De Matches(String) methode is vergelijkbaar met de Match(String) methode, behalve dat deze informatie retourneert over alle overeenkomsten in de invoertekenreeks, in plaats van één overeenkomst. De verzameling bevat alleen overeenkomsten en eindigt bij de eerste niet-overeenkomst.
De Matches(String) methode maakt gebruik van luie evaluatie om het geretourneerde MatchCollection object te vullen. Toegang tot leden van deze verzameling, zoals Count en CopyTo(Array, Int32) zorgt ervoor dat de verzameling onmiddellijk wordt ingevuld. Om te profiteren van luie evaluatie, itereert u de verzameling met behulp van foreach.
Vanwege de luie evaluatie genereert Matches(String) het aanroepen van de RegexMatchTimeoutException methode geen uitzondering. De uitzondering wordt echter gegenereerd wanneer een bewerking wordt uitgevoerd op het MatchCollection object dat door deze methode wordt geretourneerd, als de MatchTimeout eigenschap niet InfiniteMatchTimeout is en een overeenkomende bewerking het time-outinterval overschrijdt.
Zie ook
Van toepassing op
Matches(String, String)
- Bron:
- Regex.Match.cs
- Bron:
- Regex.Match.cs
- Bron:
- Regex.Match.cs
- Bron:
- Regex.Match.cs
- Bron:
- Regex.Match.cs
Hiermee wordt gezocht naar de opgegeven invoertekenreeks voor alle exemplaren van een opgegeven reguliere expressie.
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 MatchCollectionParameters
- input
- String
De tekenreeks om naar een overeenkomst te zoeken.
- pattern
- String
Het reguliere expressiepatroon dat moet overeenkomen.
Retouren
Een verzameling van de Match objecten die door de zoekopdracht zijn gevonden. Als er geen overeenkomsten worden gevonden, retourneert de methode een leeg verzamelingsobject.
Uitzonderingen
Er is een reguliere expressieparseringsfout opgetreden.
input of pattern is null.
Opmerkingen
De Matches(String, String) methode is vergelijkbaar met de Match(String, String) methode, behalve dat deze informatie retourneert over alle overeenkomsten in de invoertekenreeks, in plaats van één overeenkomst.
De statische Matches methoden zijn gelijk aan het maken van een Regex object met het opgegeven reguliere expressiepatroon en het aanroepen van de instantiemethode Matches.
De Matches(String, String) methode maakt gebruik van luie evaluatie om het geretourneerde MatchCollection object te vullen. Toegang tot leden van deze verzameling, zoals Count en CopyTo(Array, Int32) zorgt ervoor dat de verzameling onmiddellijk wordt ingevuld. Om te profiteren van luie evaluatie, itereert u de verzameling met behulp van foreach.
Vanwege de luie evaluatie genereert Matches(String, String) het aanroepen van de RegexMatchTimeoutException methode geen uitzondering. De uitzondering wordt echter gegenereerd wanneer een bewerking wordt uitgevoerd op het MatchCollection object dat door deze methode wordt geretourneerd, als een overeenkomende bewerking het time-outinterval overschrijdt.
Notities voor bellers
Deze methode treedt op na een interval dat gelijk is aan de standaardtime-outwaarde van het toepassingsdomein waarin deze wordt aangeroepen. Als er geen time-outwaarde is gedefinieerd voor het toepassingsdomein, wordt de waarde InfiniteMatchTimeout, waardoor er geen time-out optreedt voor de methode, gebruikt. De aanbevolen statische methode voor het ophalen van meerdere patroonovereenkomsten is Matches(String, String, RegexOptions, TimeSpan), waarmee u het time-outinterval kunt opgeven.
