Regex.IsMatch Metodo

Definizione

Spazio dei nomi:: System.Text.RegularExpressions

Assembly:: System.dll, System.Text.RegularExpressions.dll

Assembly:: netstandard.dll, System.Text.RegularExpressions.dll

Assembly:: System.Text.RegularExpressions.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Indica se l'espressione regolare trova una corrispondenza nella stringa di input.

Overload

Nome	Descrizione
IsMatch(String, String, RegexOptions, TimeSpan)	Indica se l'espressione regolare specificata trova una corrispondenza nella stringa di input specificata, utilizzando le opzioni di corrispondenza specificate e l'intervallo di timeout.
IsMatch(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)	Indica se l'espressione regolare specificata trova una corrispondenza nell'intervallo di input specificato, utilizzando le opzioni di corrispondenza specificate e l'intervallo di timeout.
IsMatch(String, String, RegexOptions)	Indica se l'espressione regolare specificata trova una corrispondenza nella stringa di input specificata, utilizzando le opzioni di corrispondenza specificate.
IsMatch(ReadOnlySpan<Char>, String, RegexOptions)	Indica se l'espressione regolare specificata trova una corrispondenza nell'intervallo di input specificato, utilizzando le opzioni di corrispondenza specificate.
IsMatch(String, String)	Indica se l'espressione regolare specificata trova una corrispondenza nella stringa di input specificata.
IsMatch(ReadOnlySpan<Char>, Int32)	Indica se l'espressione regolare specificata nel Regex costruttore trova una corrispondenza in un intervallo di input specificato, a partire dalla posizione specificata.
IsMatch(ReadOnlySpan<Char>, String)	Indica se l'espressione regolare specificata trova una corrispondenza nell'intervallo di input specificato.
IsMatch(String, Int32)	Indica se l'espressione regolare specificata nel Regex costruttore trova una corrispondenza nella stringa di input specificata, a partire dalla posizione iniziale specificata nella stringa.
IsMatch(String)	Indica se l'espressione regolare specificata nel Regex costruttore trova una corrispondenza in una stringa di input specificata.
IsMatch(ReadOnlySpan<Char>)	Indica se l'espressione regolare specificata nel Regex costruttore trova una corrispondenza in un intervallo di input specificato.

IsMatch(String, String, RegexOptions, TimeSpan)

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Indica se l'espressione regolare specificata trova una corrispondenza nella stringa di input specificata, utilizzando le opzioni di corrispondenza specificate e l'intervallo di timeout.

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

Parametri

input: String

Stringa in cui cercare una corrispondenza.

pattern: String

Modello di espressione regolare da trovare in corrispondenza.

options: RegexOptions

Combinazione bit per bit dei valori di enumerazione che forniscono opzioni per la corrispondenza.

matchTimeout: TimeSpan

Intervallo di timeout o InfiniteMatchTimeout per indicare che il metodo non deve scadere.

Valori restituiti

Boolean

true se l'espressione regolare trova una corrispondenza; in caso contrario, false.

Eccezioni

ArgumentException

Si è verificato un errore di analisi delle espressioni regolari.

ArgumentNullException

input o pattern è null.

ArgumentOutOfRangeException

options non è un valore valido RegexOptions . -oppure- matchTimeout è negativo, zero o maggiore di circa 24 giorni.

RegexMatchTimeoutException

Si è verificato un timeout.

Commenti

Il IsMatch(String, String, RegexOptions, TimeSpan) metodo viene in genere usato per convalidare una stringa o per assicurarsi che una stringa sia conforme a un modello specifico senza recuperare tale stringa per la manipolazione successiva. Per recuperare le stringhe corrispondenti, chiamare invece il Match(String, String, RegexOptions, TimeSpan) metodo o Matches(String, String, RegexOptions, TimeSpan) .

Il metodo statico IsMatch(String, String, RegexOptions, TimeSpan) equivale a costruire un Regex oggetto con il modello e le opzioni specificati e chiamando il metodo di IsMatch(String) istanza. Il modello viene memorizzato nella cache per il recupero rapido dal motore delle espressioni regolari.

Il matchTimeout parametro specifica per quanto tempo un metodo di ricerca dei criteri deve provare a trovare una corrispondenza prima del timeout. L'impostazione di un intervallo di timeout impedisce che le espressioni regolari che si basano su un backtracking eccessivo vengano visualizzate per interrompere la risposta quando elaborano l'input che contiene corrispondenze vicine. Se non viene trovata alcuna corrispondenza in tale intervallo di tempo, il metodo genera un'eccezione RegexMatchTimeoutException . matchTimeout esegue l'override di qualsiasi valore di timeout predefinito definito per il dominio applicazione in cui viene eseguito il metodo.

Note per i chiamanti

È consigliabile impostare il matchTimeout parametro su un valore appropriato, ad esempio due secondi. Se si disabilitano i timeout specificando InfiniteMatchTimeout, il motore delle espressioni regolari offre prestazioni leggermente migliori. Tuttavia, è consigliabile disabilitare i timeout solo nelle condizioni seguenti:

Quando l'input elaborato da un'espressione regolare è derivato da un'origine nota e attendibile o è costituito da testo statico. Questo esclude il testo che è stato immesso dinamicamente dagli utenti.
Quando il criterio di espressione regolare è stato testato accuratamente per garantire che gestisca in modo efficiente corrispondenze, non corrispondenze e corrispondenze vicine.
Quando il criterio di espressione regolare non contiene elementi del linguaggio noti per causare un backtracking eccessivo durante l'elaborazione di una corrispondenza vicina.

Vedi anche

Elementi del linguaggio delle espressioni regolari

Si applica a

IsMatch(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Indica se l'espressione regolare specificata trova una corrispondenza nell'intervallo di input specificato, utilizzando le opzioni di corrispondenza specificate e l'intervallo di timeout.

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

Parametri

input: ReadOnlySpan<Char>

Intervallo in cui cercare una corrispondenza.

pattern: String

Modello di espressione regolare da trovare in corrispondenza.

options: RegexOptions

Combinazione bit per bit dei valori di enumerazione che forniscono opzioni per la corrispondenza.

matchTimeout: TimeSpan

Intervallo di timeout o InfiniteMatchTimeout per indicare che il metodo non deve scadere.

Valori restituiti

Boolean

true se l'espressione regolare trova una corrispondenza; in caso contrario, false.

Eccezioni

ArgumentException

Si è verificato un errore di analisi delle espressioni regolari.

ArgumentNullException

pattern è null.

RegexMatchTimeoutException

Si è verificato un timeout.

ArgumentOutOfRangeException

options non è un valore valido RegexOptions oppure matchTimeout è negativo, zero o maggiore di circa 24 giorni.

Si applica a

IsMatch(String, String, RegexOptions)

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Indica se l'espressione regolare specificata trova una corrispondenza nella stringa di input specificata, utilizzando le opzioni di corrispondenza specificate.

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

Parametri

input: String

Stringa in cui cercare una corrispondenza.

pattern: String

Modello di espressione regolare da trovare in corrispondenza.

options: RegexOptions

Combinazione bit per bit dei valori di enumerazione che forniscono opzioni per la corrispondenza.

Valori restituiti

Boolean

true se l'espressione regolare trova una corrispondenza; in caso contrario, false.

Eccezioni

ArgumentException

Si è verificato un errore di analisi delle espressioni regolari.

ArgumentNullException

input o pattern è null.

ArgumentOutOfRangeException

options non è un valore valido RegexOptions .

RegexMatchTimeoutException

Si è verificato un timeout.

Commenti

Il IsMatch(String, String, RegexOptions) metodo viene in genere usato per convalidare una stringa o per assicurarsi che una stringa sia conforme a un modello specifico senza recuperare tale stringa per la manipolazione successiva. Per recuperare le stringhe corrispondenti, chiamare invece il Match(String, String, RegexOptions) metodo o Matches(String, String, RegexOptions) .

Il metodo statico IsMatch(String, String, RegexOptions) equivale a costruire un Regex oggetto con il modello e le opzioni specificati e chiamando il metodo di IsMatch(String) istanza. Il modello viene memorizzato nella cache per il recupero rapido dal motore delle espressioni regolari.

Note per i chiamanti

Questo metodo si verifica il timeout dopo un intervallo uguale al valore di timeout predefinito del dominio applicazione in cui viene chiamato. Se per il dominio applicazione non è stato definito un valore di timeout, viene usato il valore InfiniteMatchTimeout, che impedisce il timeout del metodo. Il metodo statico consigliato per verificare una corrispondenza del criterio è IsMatch(String, String, RegexOptions, TimeSpan), che consente di impostare l'intervallo di timeout.

Vedi anche

Elementi del linguaggio delle espressioni regolari

Si applica a

IsMatch(ReadOnlySpan<Char>, String, RegexOptions)

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Indica se l'espressione regolare specificata trova una corrispondenza nell'intervallo di input specificato, utilizzando le opzioni di corrispondenza specificate.

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

Parametri

input: ReadOnlySpan<Char>

Intervallo in cui cercare una corrispondenza.

pattern: String

Modello di espressione regolare da trovare in corrispondenza.

options: RegexOptions

Combinazione bit per bit dei valori di enumerazione che forniscono opzioni per la corrispondenza.

Valori restituiti

Boolean

true se l'espressione regolare trova una corrispondenza; in caso contrario, false.

Eccezioni

ArgumentException

Si è verificato un errore di analisi delle espressioni regolari.

ArgumentNullException

pattern è null.

RegexMatchTimeoutException

Si è verificato un timeout.

ArgumentOutOfRangeException

options non è un valore valido RegexOptions .

Si applica a

IsMatch(String, String)

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Indica se l'espressione regolare specificata trova una corrispondenza nella stringa di input specificata.

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

Parametri

input: String

Stringa in cui cercare una corrispondenza.

pattern: String

Modello di espressione regolare da trovare in corrispondenza.

Valori restituiti

Boolean

true se l'espressione regolare trova una corrispondenza; in caso contrario, false.

Eccezioni

ArgumentException

Si è verificato un errore di analisi delle espressioni regolari.

ArgumentNullException

input o pattern è null.

RegexMatchTimeoutException

Si è verificato un timeout.

Commenti

Il IsMatch(String, String) metodo viene in genere usato per convalidare una stringa o per assicurarsi che una stringa sia conforme a un modello specifico senza recuperare tale stringa per la manipolazione successiva. Per recuperare le stringhe corrispondenti, chiamare invece il Match(String, String) metodo o Matches(String, String) .

Il metodo statico IsMatch(String, String) equivale a costruire un Regex oggetto con il modello specificato e a chiamare il metodo di IsMatch(String) istanza. Il modello viene memorizzato nella cache per il recupero rapido dal motore delle espressioni regolari.

Note per i chiamanti

Questo metodo si verifica il timeout dopo un intervallo uguale al valore di timeout predefinito del dominio applicazione in cui viene chiamato il metodo . Se per il dominio applicazione non è stato definito un valore di timeout, viene usato il valore InfiniteMatchTimeout, che impedisce il timeout del metodo. Il metodo statico consigliato per verificare una corrispondenza del criterio è IsMatch(String, String, RegexOptions, TimeSpan), che consente di impostare l'intervallo di timeout.

Vedi anche

Elementi del linguaggio delle espressioni regolari

Si applica a

IsMatch(ReadOnlySpan<Char>, Int32)

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Indica se l'espressione regolare specificata nel Regex costruttore trova una corrispondenza in un intervallo di input specificato, a partire dalla posizione specificata.

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

Parametri

input: ReadOnlySpan<Char>

Intervallo in cui cercare una corrispondenza.

startat: Int32

Posizione del carattere in base zero in corrispondenza della quale avviare la ricerca.

Valori restituiti

Boolean

true se l'espressione regolare trova una corrispondenza; in caso contrario, false.

Eccezioni

RegexMatchTimeoutException

Si è verificato un timeout.

Si applica a

IsMatch(ReadOnlySpan<Char>, String)

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Indica se l'espressione regolare specificata trova una corrispondenza nell'intervallo di input specificato.

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

Parametri

input: ReadOnlySpan<Char>

Intervallo in cui cercare una corrispondenza.

pattern: String

Modello di espressione regolare da trovare in corrispondenza.

Valori restituiti

Boolean

true se l'espressione regolare trova una corrispondenza; in caso contrario, false.

Eccezioni

ArgumentException

Si è verificato un errore di analisi delle espressioni regolari.

ArgumentNullException

pattern è null.

RegexMatchTimeoutException

Si è verificato un timeout.

Si applica a

IsMatch(String, Int32)

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Indica se l'espressione regolare specificata nel Regex costruttore trova una corrispondenza nella stringa di input specificata, a partire dalla posizione iniziale specificata nella stringa.

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

Parametri

input: String

Stringa in cui cercare una corrispondenza.

startat: Int32

Posizione del carattere in corrispondenza della quale avviare la ricerca.

Valori restituiti

Boolean

true se l'espressione regolare trova una corrispondenza; in caso contrario, false.

Eccezioni

ArgumentNullException

input è null.

ArgumentOutOfRangeException

startat è minore di zero o maggiore della lunghezza di input.

RegexMatchTimeoutException

Si è verificato un timeout.

Commenti

Il IsMatch(String, Int32) metodo viene in genere usato per convalidare una stringa o per assicurarsi che una stringa sia conforme a un modello specifico senza recuperare tale stringa per la manipolazione successiva. Per recuperare le stringhe corrispondenti, chiamare invece il Match(String, Int32) metodo o Matches(String, Int32) .

Per altri dettagli su startat, vedere le osservazioni per Match(String, Int32).

Vedi anche

Elementi del linguaggio delle espressioni regolari

Si applica a

IsMatch(String)

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Indica se l'espressione regolare specificata nel Regex costruttore trova una corrispondenza in una stringa di input specificata.

public:
 bool IsMatch(System::String ^ input);

public bool IsMatch(string input);

member this.IsMatch : string -> bool

Public Function IsMatch (input As String) As Boolean

Parametri

input: String

Stringa in cui cercare una corrispondenza.

Valori restituiti

Boolean

true se l'espressione regolare trova una corrispondenza; in caso contrario, false.

Eccezioni

ArgumentNullException

input è null.

RegexMatchTimeoutException

Si è verificato un timeout.

Commenti

Il IsMatch(String) metodo viene in genere usato per convalidare una stringa o per assicurarsi che una stringa sia conforme a un modello specifico senza recuperare tale stringa per la manipolazione successiva. Per determinare se una o più stringhe corrispondono a un criterio di espressione regolare e recuperarle per la successiva manipolazione, chiamare il Match(String) metodo o Matches(String) .

L'eccezione RegexMatchTimeoutException viene generata se il tempo di esecuzione dell'operazione corrispondente supera l'intervallo di timeout specificato dal costruttore Regex(String, RegexOptions, TimeSpan). Se non si imposta un intervallo di timeout quando si chiama il costruttore, l'eccezione viene generata se l'operazione supera qualsiasi valore di timeout stabilito per il dominio applicazione in cui viene creato l'oggetto Regex. Se non viene definito alcun timeout nella chiamata al costruttore Regex o nelle proprietà del dominio applicazione oppure se il valore di timeout è InfiniteMatchTimeout, non viene generata alcuna eccezione.

Vedi anche

Elementi del linguaggio delle espressioni regolari

Si applica a

IsMatch(ReadOnlySpan<Char>)

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Origine:: Regex.Match.cs

Indica se l'espressione regolare specificata nel Regex costruttore trova una corrispondenza in un intervallo di input specificato.

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

Parametri

input: ReadOnlySpan<Char>

Intervallo in cui cercare una corrispondenza.

Valori restituiti

Boolean

true se l'espressione regolare trova una corrispondenza; in caso contrario, false.

Eccezioni

RegexMatchTimeoutException

Si è verificato un timeout.

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?