Match Classe

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
Origine:
Match.cs
Origine:
Match.cs
Origine:
Match.cs
Origine:
Match.cs
Origine:
Match.cs

Rappresenta i risultati di una singola corrispondenza di espressione regolare.

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
Ereditarietà
Object
Capture
Group
Match
Attributi
SerializableAttribute

Commenti

La Match classe non è modificabile e non dispone di un costruttore pubblico. Un'istanza della Match classe viene restituita dal Match(String) metodo e rappresenta la prima corrispondenza del criterio in una stringa. Le corrispondenze successive sono rappresentate da Match oggetti restituiti dal NextMatch() metodo . Inoltre, un MatchCollection oggetto costituito da zero, uno o più Match oggetti viene restituito dal Matches(String) metodo .

Se il Matches(String) metodo non corrisponde a un criterio di espressione regolare in una stringa di input, restituisce un oggetto vuoto MatchCollection . È quindi possibile usare un foreach costrutto per scorrere la raccolta.

Se il Match(String) metodo non corrisponde al criterio di espressione regolare, restituisce un Match oggetto uguale a Empty. È possibile utilizzare la Success proprietà per determinare se la corrispondenza ha avuto esito positivo.

Se una corrispondenza del criterio ha esito positivo, la Value proprietà contiene la sottostringa corrispondente, la Index proprietà indica la posizione iniziale in base zero della sottostringa corrispondente nella stringa di input e la Length proprietà indica la lunghezza della sottostringa corrispondente nella stringa di input.

Poiché una singola corrispondenza può comportare più gruppi di acquisizione, Match ha una Groups proprietà che restituisce .GroupCollection L'istanza Match stessa equivale al primo oggetto dell'insieme, in Match.Groups[0], che rappresenta l'intera corrispondenza.

Proprietà

Nome Descrizione
Captures

Ottiene una raccolta di tutte le acquisizioni corrispondenti al gruppo di acquisizione, nell'ordine più a sinistra all'estrema sinistra o nell'ordine più a destra se l'espressione regolare viene modificata con l'opzione RightToLeft . La raccolta può contenere zero o più elementi.

(Ereditato da Group)
Empty

Ottiene la corrispondenza vuota. Tutte le corrispondenze non riuscite restituiscono questa corrispondenza vuota.
Groups

Ottiene una raccolta di gruppi corrispondenti all'espressione regolare.
Index

Ottiene la posizione nella stringa originale in cui viene trovato il primo carattere della sottostringa acquisita.

(Ereditato da Capture)
Length

Ottiene la lunghezza della sottostringa acquisita.

(Ereditato da Capture)
Name

Restituisce il nome del gruppo di acquisizione rappresentato dall'istanza corrente.

(Ereditato da Group)
Success

Ottiene un valore che indica se la corrispondenza ha esito positivo.

(Ereditato da Group)
Value

Ottiene la sottostringa acquisita dalla stringa di input.

(Ereditato da Capture)
ValueSpan

Ottiene l'intervallo acquisito dalla stringa di input.

(Ereditato da Capture)

Metodi

Nome Descrizione
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
NextMatch()

Restituisce un nuovo Match oggetto con i risultati per la corrispondenza successiva, a partire dalla posizione in cui è terminata l'ultima corrispondenza (al carattere dopo l'ultimo carattere corrispondente).
Result(String)

Restituisce l'espansione del modello di sostituzione passato. Ad esempio, se il modello di sostituzione è $1$2, Result(String) restituisce la concatenazione di Groups[1].Value e Groups[2].Value.
Synchronized(Match)

Restituisce un'istanza Match equivalente a quella fornita che è sicura da condividere tra più thread.
ToString()

Recupera la sottostringa acquisita dalla stringa di input chiamando la Value proprietà .

(Ereditato da Capture)

Si applica a

Vedi anche