Regex.Matches Méthode

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

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.MatchCollection

Public Shared Function Matches (input As String, pattern As String, options As RegexOptions, matchTimeout As TimeSpan) As MatchCollection

Paramètres

Retours

Collection des Match objets trouvés par la recherche. Si aucune correspondance n’est trouvée, la méthode retourne un objet de collection vide.

Exceptions

Remarques

La Matches(String, String, RegexOptions, TimeSpan) méthode est similaire à la Match(String, String, RegexOptions, TimeSpan) méthode, sauf qu’elle retourne des informations sur toutes les correspondances trouvées dans la chaîne d’entrée, au lieu d’une seule correspondance.

Les méthodes statiques Matches sont équivalentes à la construction d’un Regex objet avec le modèle d’expression régulière spécifié et à l’appel de la méthode Matchesd’instance.

La Matches(String, String, RegexOptions, TimeSpan) méthode utilise l’évaluation différée pour remplir l’objet retourné MatchCollection . L’accès aux membres de cette collection, tels que Count et CopyTo(Array, Int32) provoque le remplissage immédiat de la collection. Pour tirer parti de l’évaluation différée, itérer la collection à l’aide foreachde .

En raison de son évaluation différée, l’appel de la Matches(String, String, RegexOptions, TimeSpan) méthode ne lève pas d’exception RegexMatchTimeoutException . Toutefois, une exception est levée lorsqu’une opération est effectuée sur l’objet MatchCollection retourné par cette méthode, si une opération correspondante dépasse l’intervalle de délai d’attente spécifié par le matchTimeout paramètre.

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

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

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.MatchCollection

Public Shared Function Matches (input As String, pattern As String, options As RegexOptions) As MatchCollection

Paramètres

Retours

Collection des Match objets trouvés par la recherche. Si aucune correspondance n’est trouvée, la méthode retourne un objet de collection vide.

Exceptions

Remarques

La Matches(String, String, RegexOptions) méthode est similaire à la Match(String, String, RegexOptions) méthode, sauf qu’elle retourne des informations sur toutes les correspondances trouvées dans la chaîne d’entrée, au lieu d’une seule correspondance.

Les méthodes statiques Matches sont équivalentes à la construction d’un Regex objet avec le modèle d’expression régulière spécifié et à l’appel de la méthode Matchesd’instance.

La Matches(String, String, RegexOptions) méthode utilise l’évaluation différée pour remplir l’objet retourné MatchCollection . L’accès aux membres de cette collection, tels que Count et CopyTo(Array, Int32) provoque le remplissage immédiat de la collection. Pour tirer parti de l’évaluation différée, itérer la collection à l’aide foreachde .

En raison de son évaluation différée, l’appel de la Matches(String, String, RegexOptions) méthode ne lève pas d’exception RegexMatchTimeoutException . Toutefois, l’exception est levée lorsqu’une opération est effectuée sur l’objet MatchCollection retourné par cette méthode, si une opération correspondante dépasse l’intervalle de délai d’attente.

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 la récupération de plusieurs correspondances de modèle est Matches(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

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

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.MatchCollection

Public Function Matches (input As String, startat As Integer) As MatchCollection

Paramètres

Retours

Collection des Match objets trouvés par la recherche. Si aucune correspondance n’est trouvée, la méthode retourne un objet de collection vide.

Exceptions

Remarques

La Matches(String, Int32) méthode est similaire à la Match(String, Int32) méthode, sauf qu’elle retourne des informations sur toutes les correspondances trouvées dans la chaîne d’entrée, au lieu d’une seule correspondance.

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

La Matches(String, Int32) méthode utilise l’évaluation différée pour remplir l’objet retourné MatchCollection . L’accès aux membres de cette collection, tels que Count et CopyTo(Array, Int32) provoque le remplissage immédiat de la collection. Pour tirer parti de l’évaluation différée, itérer la collection à l’aide foreachde .

En raison de son évaluation différée, l’appel de la Matches(String, Int32) méthode ne lève pas d’exception RegexMatchTimeoutException . Toutefois, l’exception est levée lorsqu’une opération est effectuée sur l’objet MatchCollection retourné par cette méthode, si la MatchTimeout propriété n’est pas InfiniteMatchTimeout et qu’une opération correspondante dépasse l’intervalle de délai d’attente.

Voir aussi

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

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

public:
 System::Text::RegularExpressions::MatchCollection ^ Matches(System::String ^ input);

public System.Text.RegularExpressions.MatchCollection Matches(string input);

member this.Matches : string -> System.Text.RegularExpressions.MatchCollection

Public Function Matches (input As String) As MatchCollection

Paramètres

Retours

Collection des Match objets trouvés par la recherche. Si aucune correspondance n’est trouvée, la méthode retourne un objet de collection vide.

Exceptions

Remarques

La Matches(String) méthode est similaire à la Match(String) méthode, sauf qu’elle retourne des informations sur toutes les correspondances trouvées dans la chaîne d’entrée, au lieu d’une seule correspondance. La collection inclut uniquement les correspondances et se termine au premier non-correspondance.

La Matches(String) méthode utilise l’évaluation différée pour remplir l’objet retourné MatchCollection . L’accès aux membres de cette collection, tels que Count et CopyTo(Array, Int32) provoque le remplissage immédiat de la collection. Pour tirer parti de l’évaluation différée, itérer la collection à l’aide foreachde .

En raison de son évaluation différée, l’appel de la Matches(String) méthode ne lève pas d’exception RegexMatchTimeoutException . Toutefois, l’exception est levée lorsqu’une opération est effectuée sur l’objet MatchCollection retourné par cette méthode, si la MatchTimeout propriété n’est pas InfiniteMatchTimeout et qu’une opération correspondante dépasse l’intervalle de délai d’attente.

Voir aussi

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

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

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.MatchCollection

Public Shared Function Matches (input As String, pattern As String) As MatchCollection

Paramètres

Retours

Collection des Match objets trouvés par la recherche. Si aucune correspondance n’est trouvée, la méthode retourne un objet de collection vide.

Exceptions

Remarques

La Matches(String, String) méthode est similaire à la Match(String, String) méthode, sauf qu’elle retourne des informations sur toutes les correspondances trouvées dans la chaîne d’entrée, au lieu d’une seule correspondance.

Les méthodes statiques Matches sont équivalentes à la construction d’un Regex objet avec le modèle d’expression régulière spécifié et à l’appel de la méthode Matchesd’instance.

La Matches(String, String) méthode utilise l’évaluation différée pour remplir l’objet retourné MatchCollection . L’accès aux membres de cette collection, tels que Count et CopyTo(Array, Int32) provoque le remplissage immédiat de la collection. Pour tirer parti de l’évaluation différée, itérer la collection à l’aide foreachde .

En raison de son évaluation différée, l’appel de la Matches(String, String) méthode ne lève pas d’exception RegexMatchTimeoutException . Toutefois, l’exception est levée lorsqu’une opération est effectuée sur l’objet MatchCollection retourné par cette méthode, si une opération correspondante dépasse l’intervalle de délai d’attente.

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 récupérer plusieurs correspondances de modèle est Matches(String, String, RegexOptions, TimeSpan), ce qui vous permet de spécifier l’intervalle de délai d’attente.

Voir aussi

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