Regex.IsMatch 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.
Anger om det reguljära uttrycket hittar en matchning i indatasträngen.
Överlagringar
| Name | Description |
|---|---|
| IsMatch(String, String, RegexOptions, TimeSpan) |
Anger om det angivna reguljära uttrycket hittar en matchning i den angivna indatasträngen med hjälp av de angivna matchningsalternativen och tidsgränsintervallet. |
| IsMatch(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan) |
Anger om det angivna reguljära uttrycket hittar en matchning i det angivna indataintervallet med hjälp av de angivna matchningsalternativen och tidsgränsintervallet. |
| IsMatch(String, String, RegexOptions) |
Anger om det angivna reguljära uttrycket hittar en matchning i den angivna indatasträngen med hjälp av de angivna matchningsalternativen. |
| IsMatch(ReadOnlySpan<Char>, String, RegexOptions) |
Anger om det angivna reguljära uttrycket hittar en matchning i det angivna indataintervallet med hjälp av de angivna matchningsalternativen. |
| IsMatch(String, String) |
Anger om det angivna reguljära uttrycket hittar en matchning i den angivna indatasträngen. |
| IsMatch(ReadOnlySpan<Char>, Int32) |
Anger om det reguljära uttrycket som anges i Regex konstruktorn hittar en matchning i ett angivet indataintervall med början på den angivna positionen. |
| IsMatch(ReadOnlySpan<Char>, String) |
Anger om det angivna reguljära uttrycket hittar en matchning i det angivna indataintervallet. |
| IsMatch(String, Int32) |
Anger om det reguljära uttrycket som anges i Regex konstruktorn hittar en matchning i den angivna indatasträngen med början vid den angivna startpositionen i strängen. |
| IsMatch(String) |
Anger om det reguljära uttrycket som anges i Regex konstruktorn hittar en matchning i en angiven indatasträng. |
| IsMatch(ReadOnlySpan<Char>) |
Anger om det reguljära uttrycket som anges i Regex konstruktorn hittar en matchning i ett angivet indataintervall. |
IsMatch(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
Anger om det angivna reguljära uttrycket hittar en matchning i den angivna indatasträngen med hjälp av de angivna matchningsalternativen och tidsgränsintervallet.
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 -> bool
Public Shared Function IsMatch (input As String, pattern As String, options As RegexOptions, matchTimeout As TimeSpan) As Boolean
Parametrar
- 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 ger alternativ för matchning.
- matchTimeout
- TimeSpan
Ett tidsgränsintervall, eller InfiniteMatchTimeout för att indikera att metoden inte bör överskrida tidsgränsen.
Returer
trueom det reguljära uttrycket hittar en matchning; annars . false
Undantag
Ett fel uppstod vid parsning av reguljära uttryck.
input eller pattern är null.
options är inte ett giltigt RegexOptions värde.
-or- matchTimeout är negativ, noll eller större än cirka 24 dagar.
En timeout inträffade.
Kommentarer
Metoden IsMatch(String, String, RegexOptions, TimeSpan) används vanligtvis för att verifiera en sträng eller för att säkerställa att en sträng överensstämmer med ett visst mönster utan att hämta strängen för efterföljande manipulering. Om du vill hämta matchade strängar anropar Match(String, String, RegexOptions, TimeSpan) du metoden eller Matches(String, String, RegexOptions, TimeSpan) i stället.
Den statiska IsMatch(String, String, RegexOptions, TimeSpan) metoden motsvarar konstruera ett Regex objekt med det angivna mönstret och alternativen och anropa IsMatch(String) instansmetoden. Mönstret cachelagras för snabb hämtning av motorn för reguljära uttryck.
Parametern matchTimeout anger hur länge en mönstermatchningsmetod ska försöka hitta en matchning innan tidsgränsen uppnås. Om du anger ett tidsgränsintervall förhindras reguljära uttryck som förlitar sig på överdriven bakåtspårning från att verka sluta svara när de bearbetar indata som innehåller nära matchningar. Om ingen matchning hittas i det tidsintervallet utlöser metoden ett RegexMatchTimeoutException undantag.
matchTimeout åsidosätter alla standardvärden för timeout som definierats för programdomänen där metoden körs.
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
IsMatch(ReadOnlySpan<Char>, 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
Anger om det angivna reguljära uttrycket hittar en matchning i det angivna indataintervallet med hjälp av de angivna matchningsalternativen och tidsgränsintervallet.
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 -> bool
Public Shared Function IsMatch (input As ReadOnlySpan(Of Char), pattern As String, options As RegexOptions, matchTimeout As TimeSpan) As Boolean
Parametrar
- input
- ReadOnlySpan<Char>
Intervallet 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 ger alternativ för matchning.
- matchTimeout
- TimeSpan
Ett tidsgränsintervall, eller InfiniteMatchTimeout för att indikera att metoden inte bör överskrida tidsgränsen.
Returer
trueom det reguljära uttrycket hittar en matchning; annars . false
Undantag
Ett fel uppstod vid parsning av reguljära uttryck.
pattern är null.
En timeout inträffade.
options är inte ett giltigt RegexOptions värde – eller – matchTimeout är negativt, noll eller större än cirka 24 dagar.
Gäller för
IsMatch(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
Anger om det angivna reguljära uttrycket hittar en matchning i den angivna indatasträngen med hjälp av de angivna matchningsalternativen.
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 -> bool
Public Shared Function IsMatch (input As String, pattern As String, options As RegexOptions) As Boolean
Parametrar
- 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 ger alternativ för matchning.
Returer
trueom det reguljära uttrycket hittar en matchning; annars . false
Undantag
Ett fel uppstod vid parsning av reguljära uttryck.
input eller pattern är null.
options är inte ett giltigt RegexOptions värde.
En timeout inträffade.
Kommentarer
Metoden IsMatch(String, String, RegexOptions) används vanligtvis för att verifiera en sträng eller för att säkerställa att en sträng överensstämmer med ett visst mönster utan att hämta strängen för efterföljande manipulering. Om du vill hämta matchade strängar anropar Match(String, String, RegexOptions) du metoden eller Matches(String, String, RegexOptions) i stället.
Den statiska IsMatch(String, String, RegexOptions) metoden motsvarar konstruera ett Regex objekt med det angivna mönstret och alternativen och anropa IsMatch(String) instansmetoden. Mönstret cachelagras för snabb hämtning av motorn för reguljära uttryck.
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 verifiera en mönstermatchning är IsMatch(String, String, RegexOptions, TimeSpan), vilket gör att du kan ange tidsgränsintervallet.
Se även
Gäller för
IsMatch(ReadOnlySpan<Char>, 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
Anger om det angivna reguljära uttrycket hittar en matchning i det angivna indataintervallet med hjälp av de angivna matchningsalternativen.
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 -> bool
Public Shared Function IsMatch (input As ReadOnlySpan(Of Char), pattern As String, options As RegexOptions) As Boolean
Parametrar
- input
- ReadOnlySpan<Char>
Intervallet 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 ger alternativ för matchning.
Returer
trueom det reguljära uttrycket hittar en matchning; annars . false
Undantag
Ett fel uppstod vid parsning av reguljära uttryck.
pattern är null.
En timeout inträffade.
options är inte ett giltigt RegexOptions värde.
Gäller för
IsMatch(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
Anger om det angivna reguljära uttrycket hittar en matchning i den angivna indatasträngen.
public:
static bool IsMatch(System::String ^ input, System::String ^ pattern);
public static bool IsMatch(string input, string pattern);
static member IsMatch : string * string -> bool
Public Shared Function IsMatch (input As String, pattern As String) As Boolean
Parametrar
- input
- String
Strängen för att söka efter en matchning.
- pattern
- String
Det reguljära uttrycksmönster som ska matchas.
Returer
trueom det reguljära uttrycket hittar en matchning; annars . false
Undantag
Ett fel uppstod vid parsning av reguljära uttryck.
input eller pattern är null.
En timeout inträffade.
Kommentarer
Metoden IsMatch(String, String) används vanligtvis för att verifiera en sträng eller för att säkerställa att en sträng överensstämmer med ett visst mönster utan att hämta strängen för efterföljande manipulering. Om du vill hämta matchade strängar anropar Match(String, String) du metoden eller Matches(String, String) i stället.
Den statiska IsMatch(String, String) metoden motsvarar konstruera ett Regex objekt med det angivna mönstret och anropa IsMatch(String) instansmetoden. Mönstret cachelagras för snabb hämtning av motorn för reguljära uttryck.
Anteckningar till anropare
Den här metoden överskrider tidsgränsen efter ett intervall som är lika med standardvärdet för tidsgränsen för programdomänen där metoden 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 verifiera en mönstermatchning är IsMatch(String, String, RegexOptions, TimeSpan), vilket gör att du kan ange tidsgränsintervallet.
Se även
Gäller för
IsMatch(ReadOnlySpan<Char>, 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
Anger om det reguljära uttrycket som anges i Regex konstruktorn hittar en matchning i ett angivet indataintervall med början på den angivna positionen.
public:
bool IsMatch(ReadOnlySpan<char> input, int startat);
public bool IsMatch(ReadOnlySpan<char> input, int startat);
member this.IsMatch : ReadOnlySpan<char> * int -> bool
Public Function IsMatch (input As ReadOnlySpan(Of Char), startat As Integer) As Boolean
Parametrar
- input
- ReadOnlySpan<Char>
Intervallet för att söka efter en matchning.
- startat
- Int32
Den nollbaserade teckenposition där sökningen ska startas.
Returer
trueom det reguljära uttrycket hittar en matchning; annars . false
Undantag
En timeout inträffade.
Gäller för
IsMatch(ReadOnlySpan<Char>, 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
Anger om det angivna reguljära uttrycket hittar en matchning i det angivna indataintervallet.
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 -> bool
Public Shared Function IsMatch (input As ReadOnlySpan(Of Char), pattern As String) As Boolean
Parametrar
- input
- ReadOnlySpan<Char>
Intervallet för att söka efter en matchning.
- pattern
- String
Det reguljära uttrycksmönster som ska matchas.
Returer
trueom det reguljära uttrycket hittar en matchning; annars . false
Undantag
Ett fel uppstod vid parsning av reguljära uttryck.
pattern är null.
En timeout inträffade.
Gäller för
IsMatch(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
Anger om det reguljära uttrycket som anges i Regex konstruktorn hittar en matchning i den angivna indatasträngen med början vid den angivna startpositionen i strängen.
public:
bool IsMatch(System::String ^ input, int startat);
public bool IsMatch(string input, int startat);
member this.IsMatch : string * int -> bool
Public Function IsMatch (input As String, startat As Integer) As Boolean
Parametrar
- input
- String
Strängen för att söka efter en matchning.
- startat
- Int32
Teckenpositionen där sökningen ska startas.
Returer
trueom det reguljära uttrycket hittar en matchning; annars . false
Undantag
input är null.
startat är mindre än noll eller större än längden på input.
En timeout inträffade.
Kommentarer
Metoden IsMatch(String, Int32) används vanligtvis för att verifiera en sträng eller för att säkerställa att en sträng överensstämmer med ett visst mönster utan att hämta strängen för efterföljande manipulering. Om du vill hämta matchade strängar anropar Match(String, Int32) du metoden eller Matches(String, Int32) i stället.
Mer information om startatfinns i kommentarerna för Match(String, Int32).
Se även
Gäller för
IsMatch(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
Anger om det reguljära uttrycket som anges i Regex konstruktorn hittar en matchning i en angiven indatasträng.
public:
bool IsMatch(System::String ^ input);
public bool IsMatch(string input);
member this.IsMatch : string -> bool
Public Function IsMatch (input As String) As Boolean
Parametrar
- input
- String
Strängen för att söka efter en matchning.
Returer
trueom det reguljära uttrycket hittar en matchning; annars . false
Undantag
input är null.
En timeout inträffade.
Kommentarer
Metoden IsMatch(String) används vanligtvis för att verifiera en sträng eller för att säkerställa att en sträng överensstämmer med ett visst mönster utan att hämta strängen för efterföljande manipulering. Om du vill avgöra om en eller flera strängar matchar ett mönster för reguljära uttryck och hämta dem för efterföljande manipulering anropar Match(String) du metoden eller Matches(String) .
Undantaget RegexMatchTimeoutException utlöses om körningstiden för matchningsåtgärden överskrider det tidsgränsintervall som angetts av Regex(String, RegexOptions, TimeSpan) konstruktorn. Om du inte anger ett tidsgränsintervall när du anropar konstruktorn utlöses undantaget om åtgärden överskrider ett timeout-värde som har upprättats för programdomänen Regex där objektet skapas. Om ingen tidsgräns har definierats i konstruktoranropet Regex eller i programdomänens egenskaper, eller om tidsgränsvärdet är InfiniteMatchTimeout, utlöses inget undantag.
Se även
Gäller för
IsMatch(ReadOnlySpan<Char>)
- 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
Anger om det reguljära uttrycket som anges i Regex konstruktorn hittar en matchning i ett angivet indataintervall.
public:
bool IsMatch(ReadOnlySpan<char> input);
public bool IsMatch(ReadOnlySpan<char> input);
member this.IsMatch : ReadOnlySpan<char> -> bool
Public Function IsMatch (input As ReadOnlySpan(Of Char)) As Boolean
Parametrar
- input
- ReadOnlySpan<Char>
Intervallet för att söka efter en matchning.
Returer
trueom det reguljära uttrycket hittar en matchning; annars . false
Undantag
En timeout inträffade.