Regex.Matches Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Söker i en indatasträng efter alla förekomster av ett reguljärt uttryck och returnerar alla matchningar.
Överlagringar
| Name | Description |
|---|---|
| Matches(String, String, RegexOptions, TimeSpan) |
Söker i den angivna indatasträngen efter alla förekomster av ett angivet reguljärt uttryck med hjälp av de angivna matchningsalternativen och tidsgränsintervallet. |
| Matches(String, String, RegexOptions) |
Söker i den angivna indatasträngen efter alla förekomster av ett angivet reguljärt uttryck med hjälp av de angivna matchningsalternativen. |
| Matches(String, Int32) |
Söker i den angivna indatasträngen efter alla förekomster av ett reguljärt uttryck, med början vid den angivna startpositionen i strängen. |
| Matches(String) |
Söker i den angivna indatasträngen efter alla förekomster av ett reguljärt uttryck. |
| Matches(String, String) |
Söker i den angivna indatasträngen efter alla förekomster av ett angivet reguljärt uttryck. |
Matches(String, String, RegexOptions, TimeSpan)
- Källa:
- Regex.Match.cs
- Källa:
- Regex.Match.cs
- Källa:
- Regex.Match.cs
- Källa:
- Regex.Match.cs
- Källa:
- Regex.Match.cs
Söker i den angivna indatasträngen efter alla förekomster av ett angivet reguljärt uttryck med hjälp av de angivna matchningsalternativen och tidsgränsintervallet.
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 MatchCollectionParametrar
- input
- String
Strängen för att söka efter en matchning.
- pattern
- String
Det reguljära uttrycksmönster som ska matchas.
- options
- RegexOptions
En bitvis kombination av uppräkningsvärdena som anger alternativ för matchning.
- matchTimeout
- TimeSpan
Ett tidsgränsintervall, eller InfiniteMatchTimeout för att indikera att metoden inte bör överskrida tidsgränsen.
Returer
En samling av objekten som Match hittades i sökningen. Om inga matchningar hittas returnerar metoden ett tomt samlingsobjekt.
Undantag
Ett fel uppstod vid parsning av reguljära uttryck.
input eller pattern är null.
options är inte en giltig bitvis kombination av RegexOptions värden.
-or- matchTimeout är negativ, noll eller större än cirka 24 dagar.
Kommentarer
Metoden Matches(String, String, RegexOptions, TimeSpan) liknar Match(String, String, RegexOptions, TimeSpan) metoden, förutom att den returnerar information om alla matchningar som finns i indatasträngen i stället för en enda matchning.
De statiska Matches metoderna motsvarar konstruera ett Regex objekt med det angivna reguljära uttrycksmönstret och anropa instansmetoden Matches.
Metoden Matches(String, String, RegexOptions, TimeSpan) använder lat utvärdering för att fylla i det returnerade MatchCollection objektet. Åtkomst till medlemmar i den här samlingen, till exempel Count och CopyTo(Array, Int32) gör att samlingen fylls i omedelbart. Om du vill dra nytta av lat utvärdering itererar du samlingen med hjälp foreachav .
På grund av den lata utvärderingen utlöser inte anropet av Matches(String, String, RegexOptions, TimeSpan) metoden ett RegexMatchTimeoutException undantag. Ett undantag utlöses dock när en åtgärd utförs på objektet som returneras av den MatchCollection här metoden, om en matchande åtgärd överskrider det tidsgränsintervall som anges av parametern matchTimeout .
Anteckningar till anropare
Vi rekommenderar att du anger parametern matchTimeout till ett lämpligt värde, till exempel två sekunder. Om du inaktiverar tidsgränser genom att ange ger motorn för reguljära InfiniteMatchTimeoututtryck något bättre prestanda. Du bör dock inaktivera tidsgränser endast under följande villkor:
När indata som bearbetas av ett reguljärt uttryck härleds från en känd och betrodd källa eller består av statisk text. Detta exkluderar text som har matats in dynamiskt av användare.
När mönstret för reguljära uttryck har testats noggrant för att säkerställa att det effektivt hanterar matchningar, icke-matchningar och nära matchningar.
När det reguljära uttrycksmönstret inte innehåller några språkelement som är kända för att orsaka överdriven bakåtspårning vid bearbetning av en nära matchning.
Se även
Gäller för
Matches(String, String, RegexOptions)
- Källa:
- Regex.Match.cs
- Källa:
- Regex.Match.cs
- Källa:
- Regex.Match.cs
- Källa:
- Regex.Match.cs
- Källa:
- Regex.Match.cs
Söker i den angivna indatasträngen efter alla förekomster av ett angivet reguljärt uttryck med hjälp av de angivna matchningsalternativen.
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 MatchCollectionParametrar
- input
- String
Strängen för att söka efter en matchning.
- pattern
- String
Det reguljära uttrycksmönster som ska matchas.
- options
- RegexOptions
En bitvis kombination av uppräkningsvärdena som anger alternativ för matchning.
Returer
En samling av objekten som Match hittades i sökningen. Om inga matchningar hittas returnerar metoden ett tomt samlingsobjekt.
Undantag
Ett fel uppstod vid parsning av reguljära uttryck.
input eller pattern är null.
options är inte en giltig bitvis kombination av RegexOptions värden.
Kommentarer
Metoden Matches(String, String, RegexOptions) liknar Match(String, String, RegexOptions) metoden, förutom att den returnerar information om alla matchningar som finns i indatasträngen i stället för en enda matchning.
De statiska Matches metoderna motsvarar konstruera ett Regex objekt med det angivna reguljära uttrycksmönstret och anropa instansmetoden Matches.
Metoden Matches(String, String, RegexOptions) använder lat utvärdering för att fylla i det returnerade MatchCollection objektet. Åtkomst till medlemmar i den här samlingen, till exempel Count och CopyTo(Array, Int32) gör att samlingen fylls i omedelbart. Om du vill dra nytta av lat utvärdering itererar du samlingen med hjälp foreachav .
På grund av den lata utvärderingen utlöser inte anropet av Matches(String, String, RegexOptions) metoden ett RegexMatchTimeoutException undantag. Undantaget utlöses dock när en åtgärd utförs på objektet som returneras av den MatchCollection här metoden, om en matchande åtgärd överskrider tidsgränsintervallet.
Anteckningar till anropare
Den här metoden överskrider tidsgränsen efter ett intervall som är lika med standardvärdet för timeout för den programdomän där den anropas. Om ett timeout-värde inte har definierats för programdomänen används värdet InfiniteMatchTimeout, som förhindrar att metoden överskrider tidsgränsen. Den rekommenderade statiska metoden för att hämta flera mönstermatchningar är Matches(String, String, RegexOptions, TimeSpan), vilket gör att du kan ange tidsgränsintervallet.
Se även
Gäller för
Matches(String, Int32)
- Källa:
- Regex.Match.cs
- Källa:
- Regex.Match.cs
- Källa:
- Regex.Match.cs
- Källa:
- Regex.Match.cs
- Källa:
- Regex.Match.cs
Söker i den angivna indatasträngen efter alla förekomster av ett reguljärt uttryck, med början vid den angivna startpositionen i strängen.
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 MatchCollectionParametrar
- input
- String
Strängen för att söka efter en matchning.
- startat
- Int32
Teckenpositionen i indatasträngen där sökningen ska startas.
Returer
En samling av objekten som Match hittades i sökningen. Om inga matchningar hittas returnerar metoden ett tomt samlingsobjekt.
Undantag
input är null.
startat är mindre än noll eller större än längden på input.
Kommentarer
Metoden Matches(String, Int32) liknar Match(String, Int32) metoden, förutom att den returnerar information om alla matchningar som finns i indatasträngen i stället för en enda matchning.
Mer information om startatfinns i kommentarerna för Match(String, Int32).
Metoden Matches(String, Int32) använder lat utvärdering för att fylla i det returnerade MatchCollection objektet. Åtkomst till medlemmar i den här samlingen, till exempel Count och CopyTo(Array, Int32) gör att samlingen fylls i omedelbart. Om du vill dra nytta av lat utvärdering itererar du samlingen med hjälp foreachav .
På grund av den lata utvärderingen utlöser inte anropet av Matches(String, Int32) metoden ett RegexMatchTimeoutException undantag. Undantaget utlöses dock när en åtgärd utförs på objektet som returneras av den MatchCollection här metoden, om MatchTimeout egenskapen inte InfiniteMatchTimeout är det och en matchande åtgärd överskrider tidsgränsintervallet.
Se även
Gäller för
Matches(String)
- Källa:
- Regex.Match.cs
- Källa:
- Regex.Match.cs
- Källa:
- Regex.Match.cs
- Källa:
- Regex.Match.cs
- Källa:
- Regex.Match.cs
Söker i den angivna indatasträngen efter alla förekomster av ett reguljärt uttryck.
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 MatchCollectionParametrar
- input
- String
Strängen för att söka efter en matchning.
Returer
En samling av objekten som Match hittades i sökningen. Om inga matchningar hittas returnerar metoden ett tomt samlingsobjekt.
Undantag
input är null.
Kommentarer
Metoden Matches(String) liknar Match(String) metoden, förutom att den returnerar information om alla matchningar som finns i indatasträngen i stället för en enda matchning. Samlingen innehåller endast matchningar och avslutas vid den första icke-matchningen.
Metoden Matches(String) använder lat utvärdering för att fylla i det returnerade MatchCollection objektet. Åtkomst till medlemmar i den här samlingen, till exempel Count och CopyTo(Array, Int32) gör att samlingen fylls i omedelbart. Om du vill dra nytta av lat utvärdering itererar du samlingen med hjälp foreachav .
På grund av den lata utvärderingen utlöser inte anropet av Matches(String) metoden ett RegexMatchTimeoutException undantag. Undantaget utlöses dock när en åtgärd utförs på objektet som returneras av den MatchCollection här metoden, om MatchTimeout egenskapen inte InfiniteMatchTimeout är det och en matchande åtgärd överskrider tidsgränsintervallet.
Se även
Gäller för
Matches(String, String)
- Källa:
- Regex.Match.cs
- Källa:
- Regex.Match.cs
- Källa:
- Regex.Match.cs
- Källa:
- Regex.Match.cs
- Källa:
- Regex.Match.cs
Söker i den angivna indatasträngen efter alla förekomster av ett angivet reguljärt uttryck.
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 MatchCollectionParametrar
- input
- String
Strängen för att söka efter en matchning.
- pattern
- String
Det reguljära uttrycksmönster som ska matchas.
Returer
En samling av objekten som Match hittades i sökningen. Om inga matchningar hittas returnerar metoden ett tomt samlingsobjekt.
Undantag
Ett fel uppstod vid parsning av reguljära uttryck.
input eller pattern är null.
Kommentarer
Metoden Matches(String, String) liknar Match(String, String) metoden, förutom att den returnerar information om alla matchningar som finns i indatasträngen i stället för en enda matchning.
De statiska Matches metoderna motsvarar konstruera ett Regex objekt med det angivna reguljära uttrycksmönstret och anropa instansmetoden Matches.
Metoden Matches(String, String) använder lat utvärdering för att fylla i det returnerade MatchCollection objektet. Åtkomst till medlemmar i den här samlingen, till exempel Count och CopyTo(Array, Int32) gör att samlingen fylls i omedelbart. Om du vill dra nytta av lat utvärdering itererar du samlingen med hjälp foreachav .
På grund av den lata utvärderingen utlöser inte anropet av Matches(String, String) metoden ett RegexMatchTimeoutException undantag. Undantaget utlöses dock när en åtgärd utförs på objektet som returneras av den MatchCollection här metoden, om en matchande åtgärd överskrider tidsgränsintervallet.
Anteckningar till anropare
Den här metoden överskrider tidsgränsen efter ett intervall som är lika med standardvärdet för timeout för den programdomän där den anropas. Om ett timeout-värde inte har definierats för programdomänen används värdet InfiniteMatchTimeout, som förhindrar att metoden överskrider tidsgränsen. Den rekommenderade statiska metoden för att hämta flera mönstermatchningar är Matches(String, String, RegexOptions, TimeSpan), vilket gör att du kan ange tidsgränsintervallet.
