Regex.IsMatch Méthode

Définition

Espace de noms:

System.Text.RegularExpressions

Assemblys:

netstandard.dll, System.Text.RegularExpressions.dll

Indique si l’expression régulière trouve une correspondance dans la chaîne d’entrée.

Surcharges

Nom	Description
IsMatch(String, String, RegexOptions, TimeSpan)	Indique si l’expression régulière spécifiée trouve une correspondance dans la chaîne d’entrée spécifiée, à l’aide des options de correspondance et de l’intervalle de délai d’attente spécifiés.
IsMatch(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)	Indique si l’expression régulière spécifiée trouve une correspondance dans l’étendue d’entrée spécifiée, à l’aide des options de correspondance et de l’intervalle de délai d’attente spécifiés.
IsMatch(String, String, RegexOptions)	Indique si l’expression régulière spécifiée trouve une correspondance dans la chaîne d’entrée spécifiée, à l’aide des options de correspondance spécifiées.
IsMatch(ReadOnlySpan<Char>, String, RegexOptions)	Indique si l’expression régulière spécifiée trouve une correspondance dans l’étendue d’entrée spécifiée, à l’aide des options de correspondance spécifiées.
IsMatch(String, String)	Indique si l’expression régulière spécifiée trouve une correspondance dans la chaîne d’entrée spécifiée.
IsMatch(ReadOnlySpan<Char>, Int32)	Indique si l’expression régulière spécifiée dans le Regex constructeur trouve une correspondance dans une étendue d’entrée spécifiée, en commençant à la position spécifiée.
IsMatch(ReadOnlySpan<Char>, String)	Indique si l’expression régulière spécifiée trouve une correspondance dans l’étendue d’entrée spécifiée.
IsMatch(String, Int32)	Indique si l’expression régulière spécifiée dans le Regex constructeur trouve une correspondance dans la chaîne d’entrée spécifiée, en commençant à la position de départ spécifiée dans la chaîne.
IsMatch(String)	Indique si l’expression régulière spécifiée dans le Regex constructeur trouve une correspondance dans une chaîne d’entrée spécifiée.
IsMatch(ReadOnlySpan<Char>)	Indique si l’expression régulière spécifiée dans le Regex constructeur trouve une correspondance dans une étendue d’entrée spécifiée.

IsMatch(String, String, RegexOptions, TimeSpan)

Source:

Regex.Match.cs

Indique si l’expression régulière spécifiée trouve une correspondance dans la chaîne d’entrée spécifiée, à l’aide des options de correspondance et de l’intervalle de délai d’attente spécifiés.

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

Paramètres

input

String

Chaîne à rechercher une correspondance.

pattern

String

Modèle d’expression régulière à mettre en correspondance.

options

RegexOptions

Combinaison de bits des valeurs d’énumération qui fournissent des options de correspondance.

matchTimeout

TimeSpan

Intervalle de délai d’attente, ou InfiniteMatchTimeout pour indiquer que la méthode ne doit pas expirer.

Retours

Boolean

true si l’expression régulière trouve une correspondance ; sinon, false.

Exceptions

ArgumentException

Une erreur d’analyse d’expression régulière s’est produite.

ArgumentNullException

input ou pattern est null.

ArgumentOutOfRangeException

options n’est pas une valeur valide RegexOptions . -ou- matchTimeout est négatif, zéro ou supérieur à environ 24 jours.

RegexMatchTimeoutException

Un délai d’attente s’est produit.

Remarques

La IsMatch(String, String, RegexOptions, TimeSpan) méthode est généralement utilisée pour valider une chaîne ou pour s’assurer qu’une chaîne est conforme à un modèle particulier sans récupérer cette chaîne pour une manipulation ultérieure. Pour récupérer des chaînes mises en correspondance, appelez plutôt la méthode ou Matches(String, String, RegexOptions, TimeSpan) la Match(String, String, RegexOptions, TimeSpan) méthode.

La méthode statique IsMatch(String, String, RegexOptions, TimeSpan) équivaut à construire un Regex objet avec le modèle et les options spécifiés et à appeler la méthode d’instance IsMatch(String) . Le modèle est mis en cache pour une récupération rapide par le moteur d’expression régulière.

Le matchTimeout paramètre spécifie la durée pendant laquelle une méthode de correspondance de modèle doit essayer de trouver une correspondance avant qu’elle expire. La définition d’un intervalle de délai d’attente empêche les expressions régulières qui s’appuient sur un retour arrière excessif d’apparaître pour cesser de répondre lorsqu’elles traitent les entrées qui contiennent des correspondances proches. Si aucune correspondance n’est trouvée dans cet intervalle de temps, la méthode lève une RegexMatchTimeoutException exception. matchTimeout remplace toute valeur de délai d’attente par défaut définie pour le domaine d’application dans lequel la méthode s’exécute.

Notes pour les appelants

Nous vous recommandons de définir le matchTimeout paramètre sur une valeur appropriée, par exemple deux secondes. Si vous désactivez les délais d’attente en spécifiant InfiniteMatchTimeout, le moteur d’expression régulière offre des performances légèrement meilleures. Toutefois, vous devez désactiver les délais d’attente uniquement dans les conditions suivantes :

• Lorsque l’entrée traitée par une expression régulière est dérivée d’une source connue et approuvée ou se compose de texte statique. Cela exclut le texte qui a été entré dynamiquement par les utilisateurs.

• Lorsque le modèle d’expression régulière a été soigneusement testé pour s’assurer qu’il gère efficacement les correspondances, les non-correspondances et les correspondances proches.

• Lorsque le modèle d’expression régulière ne contient aucun élément de langage connu pour provoquer un retour arrière excessif lors du traitement d’une correspondance proche.

Voir aussi

• Éléments du langage d’expression régulière

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

Source:

Regex.Match.cs

Indique si l’expression régulière spécifiée trouve une correspondance dans l’étendue d’entrée spécifiée, à l’aide des options de correspondance et de l’intervalle de délai d’attente spécifiés.

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

Paramètres

input

ReadOnlySpan<Char>

Étendue à rechercher une correspondance.

pattern

String

Modèle d’expression régulière à mettre en correspondance.

options

RegexOptions

Combinaison de bits des valeurs d’énumération qui fournissent des options de correspondance.

matchTimeout

TimeSpan

Intervalle de délai d’attente, ou InfiniteMatchTimeout pour indiquer que la méthode ne doit pas expirer.

Retours

Boolean

true si l’expression régulière trouve une correspondance ; sinon, false.

Exceptions

ArgumentException

Une erreur d’analyse d’expression régulière s’est produite.

ArgumentNullException

pattern a la valeur null.

RegexMatchTimeoutException

Un délai d’attente s’est produit.

ArgumentOutOfRangeException

options n’est pas une valeur valide RegexOptions -ou- matchTimeout est négative, zéro ou supérieure à environ 24 jours.

IsMatch(String, String, RegexOptions)

Source:

Regex.Match.cs

Indique si l’expression régulière spécifiée trouve une correspondance dans la chaîne d’entrée spécifiée, à l’aide des options de correspondance spécifiées.

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

Paramètres

input

String

Chaîne à rechercher une correspondance.

pattern

String

Modèle d’expression régulière à mettre en correspondance.

options

RegexOptions

Combinaison de bits des valeurs d’énumération qui fournissent des options de correspondance.

Retours

Boolean

true si l’expression régulière trouve une correspondance ; sinon, false.

Exceptions

ArgumentException

Une erreur d’analyse d’expression régulière s’est produite.

ArgumentNullException

input ou pattern est null.

ArgumentOutOfRangeException

options n’est pas une valeur valide RegexOptions .

RegexMatchTimeoutException

Un délai d’attente s’est produit.

Remarques

La IsMatch(String, String, RegexOptions) méthode est généralement utilisée pour valider une chaîne ou pour s’assurer qu’une chaîne est conforme à un modèle particulier sans récupérer cette chaîne pour une manipulation ultérieure. Pour récupérer des chaînes mises en correspondance, appelez plutôt la méthode ou Matches(String, String, RegexOptions) la Match(String, String, RegexOptions) méthode.

La méthode statique IsMatch(String, String, RegexOptions) équivaut à construire un Regex objet avec le modèle et les options spécifiés et à appeler la méthode d’instance IsMatch(String) . Le modèle est mis en cache pour une récupération rapide par le moteur d’expression régulière.

Notes pour les appelants

Cette méthode expire après un intervalle égal à la valeur de délai d’attente par défaut du domaine d’application dans lequel elle est appelée. Si une valeur de délai d’attente n’a pas été définie pour le domaine d’application, la valeur InfiniteMatchTimeout, qui empêche la méthode de expirer, est utilisée. La méthode statique recommandée pour vérifier qu’une correspondance de modèle est IsMatch(String, String, RegexOptions, TimeSpan), ce qui vous permet de définir l’intervalle de délai d’attente.

Voir aussi

• Éléments du langage d’expression régulière

IsMatch(ReadOnlySpan<Char>, String, RegexOptions)

Source:

Regex.Match.cs

Indique si l’expression régulière spécifiée trouve une correspondance dans l’étendue d’entrée spécifiée, à l’aide des options de correspondance spécifiées.

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

Paramètres

input

ReadOnlySpan<Char>

Étendue à rechercher une correspondance.

pattern

String

Modèle d’expression régulière à mettre en correspondance.

options

RegexOptions

Combinaison de bits des valeurs d’énumération qui fournissent des options de correspondance.

Retours

Boolean

true si l’expression régulière trouve une correspondance ; sinon, false.

Exceptions

ArgumentException

Une erreur d’analyse d’expression régulière s’est produite.

ArgumentNullException

pattern a la valeur null.

RegexMatchTimeoutException

Un délai d’attente s’est produit.

ArgumentOutOfRangeException

options n’est pas une valeur valide RegexOptions .

IsMatch(String, String)

Source:

Regex.Match.cs

Indique si l’expression régulière spécifiée trouve une correspondance dans la chaîne d’entrée spécifiée.

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

Paramètres

input

String

Chaîne à rechercher une correspondance.

pattern

String

Modèle d’expression régulière à mettre en correspondance.

Retours

Boolean

true si l’expression régulière trouve une correspondance ; sinon, false.

Exceptions

ArgumentException

Une erreur d’analyse d’expression régulière s’est produite.

ArgumentNullException

input ou pattern est null.

RegexMatchTimeoutException

Un délai d’attente s’est produit.

Remarques

La IsMatch(String, String) méthode est généralement utilisée pour valider une chaîne ou pour s’assurer qu’une chaîne est conforme à un modèle particulier sans récupérer cette chaîne pour une manipulation ultérieure. Pour récupérer des chaînes mises en correspondance, appelez plutôt la méthode ou Matches(String, String) la Match(String, String) méthode.

La méthode statique IsMatch(String, String) équivaut à construire un Regex objet avec le modèle spécifié et à appeler la méthode d’instance IsMatch(String) . Le modèle est mis en cache pour une récupération rapide par le moteur d’expression régulière.

Notes pour les appelants

Cette méthode expire après un intervalle égal à la valeur de délai d’attente par défaut du domaine d’application dans lequel la méthode est appelée. Si une valeur de délai d’attente n’a pas été définie pour le domaine d’application, la valeur InfiniteMatchTimeout, qui empêche la méthode de expirer, est utilisée. La méthode statique recommandée pour vérifier qu’une correspondance de modèle est IsMatch(String, String, RegexOptions, TimeSpan), ce qui vous permet de définir l’intervalle de délai d’attente.

Voir aussi

• Éléments du langage d’expression régulière

IsMatch(ReadOnlySpan<Char>, Int32)

Source:

Regex.Match.cs

Indique si l’expression régulière spécifiée dans le Regex constructeur trouve une correspondance dans une étendue d’entrée spécifiée, en commençant à la position spécifiée.

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

Paramètres

input

ReadOnlySpan<Char>

Étendue à rechercher une correspondance.

startat

Int32

Position de caractère de base zéro à laquelle démarrer la recherche.

Retours

Boolean

true si l’expression régulière trouve une correspondance ; sinon, false.

Exceptions

RegexMatchTimeoutException

Un délai d’attente s’est produit.

IsMatch(ReadOnlySpan<Char>, String)

Source:

Regex.Match.cs

Indique si l’expression régulière spécifiée trouve une correspondance dans l’étendue d’entrée spécifiée.

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

Paramètres

input

ReadOnlySpan<Char>

Étendue à rechercher une correspondance.

pattern

String

Modèle d’expression régulière à mettre en correspondance.

Retours

Boolean

true si l’expression régulière trouve une correspondance ; sinon, false.

Exceptions

ArgumentException

Une erreur d’analyse d’expression régulière s’est produite.

ArgumentNullException

pattern a la valeur null.

RegexMatchTimeoutException

Un délai d’attente s’est produit.

IsMatch(String, Int32)

Source:

Regex.Match.cs

Indique si l’expression régulière spécifiée dans le Regex constructeur trouve une correspondance dans la chaîne d’entrée spécifiée, en commençant à la position de départ spécifiée dans la chaîne.

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

Paramètres

input

String

Chaîne à rechercher une correspondance.

startat

Int32

Position de caractère à laquelle démarrer la recherche.

Retours

Boolean

true si l’expression régulière trouve une correspondance ; sinon, false.

Exceptions

ArgumentNullException

input a la valeur null.

ArgumentOutOfRangeException

startat est inférieur à zéro ou supérieur à la longueur de input.

RegexMatchTimeoutException

Un délai d’attente s’est produit.

Remarques

La IsMatch(String, Int32) méthode est généralement utilisée pour valider une chaîne ou pour s’assurer qu’une chaîne est conforme à un modèle particulier sans récupérer cette chaîne pour une manipulation ultérieure. Pour récupérer des chaînes mises en correspondance, appelez plutôt la méthode ou Matches(String, Int32) la Match(String, Int32) méthode.

Pour plus d’informations sur startat, consultez les remarques pour Match(String, Int32).

Voir aussi

• Éléments du langage d’expression régulière

IsMatch(String)

Source:

Regex.Match.cs

Indique si l’expression régulière spécifiée dans le Regex constructeur trouve une correspondance dans une chaîne d’entrée spécifiée.

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

public bool IsMatch(string input);

member this.IsMatch : string -> bool

Public Function IsMatch (input As String) As Boolean

Paramètres

input

String

Chaîne à rechercher une correspondance.

Retours

Boolean

true si l’expression régulière trouve une correspondance ; sinon, false.

Exceptions

ArgumentNullException

input a la valeur null.

RegexMatchTimeoutException

Un délai d’attente s’est produit.

Remarques

La IsMatch(String) méthode est généralement utilisée pour valider une chaîne ou pour s’assurer qu’une chaîne est conforme à un modèle particulier sans récupérer cette chaîne pour une manipulation ultérieure. Pour déterminer si une ou plusieurs chaînes correspondent à un modèle d’expression régulière et récupérez-les pour une manipulation ultérieure, appelez la ou Matches(String) la Match(String) méthode.

L’exception RegexMatchTimeoutException est levée si l’heure d’exécution de l’opération correspondante dépasse l’intervalle de délai d’attente spécifié par le Regex(String, RegexOptions, TimeSpan) constructeur. Si vous ne définissez pas d’intervalle de délai d’attente lorsque vous appelez le constructeur, l’exception est levée si l’opération dépasse toute valeur de délai d’attente établie pour le domaine d’application dans lequel l’objet Regex est créé. Si aucun délai d’attente n’est défini dans l’appel du constructeur Regex ou dans les propriétés du domaine d’application, ou si la valeur du délai d’attente est InfiniteMatchTimeout, aucune exception n’est levée.

Voir aussi

• Éléments du langage d’expression régulière

IsMatch(ReadOnlySpan<Char>)

Source:

Regex.Match.cs

Indique si l’expression régulière spécifiée dans le Regex constructeur trouve une correspondance dans une étendue d’entrée spécifiée.

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

Paramètres

input

ReadOnlySpan<Char>

Étendue à rechercher une correspondance.

Retours

Boolean

true si l’expression régulière trouve une correspondance ; sinon, false.

Exceptions

RegexMatchTimeoutException

Un délai d’attente s’est produit.