Match Classe

Définition

Espace de noms:
System.Text.RegularExpressions
Assemblys:
System.dll, System.Text.RegularExpressions.dll
Assemblys:
netstandard.dll, System.Text.RegularExpressions.dll
Assembly:
System.Text.RegularExpressions.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Source:
Match.cs
Source:
Match.cs
Source:
Match.cs
Source:
Match.cs
Source:
Match.cs

Représente les résultats d’une correspondance d’expression régulière unique.

public ref class Match : System::Text::RegularExpressions::Group
public class Match : System.Text.RegularExpressions.Group
[System.Serializable]
public class Match : System.Text.RegularExpressions.Group
type Match = class
    inherit Group
[<System.Serializable>]
type Match = class
    inherit Group
Public Class Match
Inherits Group
Héritage
Object
Capture
Group
Match
Attributs
SerializableAttribute

Remarques

La Match classe est immuable et n’a aucun constructeur public. Une instance de la Match classe est retournée par la Match(String) méthode et représente la première correspondance de modèle dans une chaîne. Les correspondances suivantes sont représentées par Match les objets retournés par la NextMatch() méthode. En outre, un MatchCollection objet constitué de zéro, un ou plusieurs Match objets est retourné par la Matches(String) méthode.

Si la Matches(String) méthode ne correspond pas à un modèle d’expression régulière dans une chaîne d’entrée, elle retourne un objet vide MatchCollection . Vous pouvez ensuite utiliser une foreach construction pour itérer sur la collection.

Si la Match(String) méthode ne correspond pas au modèle d’expression régulière, elle retourne un Match objet égal à Empty. Vous pouvez utiliser la Success propriété pour déterminer si la correspondance a réussi.

Si une correspondance de modèle réussit, la Value propriété contient la sous-chaîne correspondante, la Index propriété indique la position de départ de base zéro de la sous-chaîne correspondante dans la chaîne d’entrée, et la Length propriété indique la longueur de la sous-chaîne correspondante dans la chaîne d’entrée.

Étant donné qu’une correspondance unique peut impliquer plusieurs groupes de capture, Match a une Groups propriété qui retourne le GroupCollection. L’instance Match elle-même équivaut au premier objet de la collection, à Match.Groups[0], qui représente l’intégralité de la correspondance.

Propriétés

Nom Description
Captures

Obtient une collection de toutes les captures mises en correspondance par le groupe de capture, dans le premier ordre le plus à gauche (ou l’ordre le plus à droite le plus à droite si l’expression régulière est modifiée avec l’option RightToLeft ). La collection peut avoir zéro ou plusieurs éléments.

(Hérité de Group)
Empty

Obtient la correspondance vide. Toutes les correspondances ayant échoué retournent cette correspondance vide.
Groups

Obtient une collection de groupes mis en correspondance par l’expression régulière.
Index

Obtient la position dans la chaîne d’origine où se trouve le premier caractère de la sous-chaîne capturée.

(Hérité de Capture)
Length

Obtient la longueur de la sous-chaîne capturée.

(Hérité de Capture)
Name

Retourne le nom du groupe de capture représenté par l’instance actuelle.

(Hérité de Group)
Success

Obtient une valeur indiquant si la correspondance réussit.

(Hérité de Group)
Value

Obtient la sous-chaîne capturée à partir de la chaîne d’entrée.

(Hérité de Capture)
ValueSpan

Obtient l’étendue capturée à partir de la chaîne d’entrée.

(Hérité de Capture)

Méthodes

Nom Description
Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
NextMatch()

Retourne un nouvel Match objet avec les résultats de la correspondance suivante, en commençant à la position à laquelle la dernière correspondance s’est terminée (à la fin du caractère après le dernier caractère mis en correspondance).
Result(String)

Retourne l’expansion du modèle de remplacement passé. Par exemple, si le modèle de remplacement est $1$2, Result(String) retourne la concaténation de Groups[1].Value et Groups[2].Value.
Synchronized(Match)

Retourne une Match instance équivalente à celle fournie qui est sûre à partager entre plusieurs threads.
ToString()

Récupère la sous-chaîne capturée à partir de la chaîne d’entrée en appelant la Value propriété.

(Hérité de Capture)

S’applique à

Voir aussi