Regex.Matches 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

Cerca in una stringa di input tutte le occorrenze di un'espressione regolare e restituisce tutte le corrispondenze.

Overload

Nome Descrizione
Matches(String, String, RegexOptions, TimeSpan)

Cerca nella stringa di input specificata tutte le occorrenze di un'espressione regolare specificata, usando le opzioni di corrispondenza specificate e l'intervallo di timeout.
Matches(String, String, RegexOptions)

Cerca nella stringa di input specificata tutte le occorrenze di un'espressione regolare specificata, usando le opzioni di corrispondenza specificate.
Matches(String, Int32)

Cerca nella stringa di input specificata tutte le occorrenze di un'espressione regolare, a partire dalla posizione iniziale specificata nella stringa.
Matches(String)

Cerca nella stringa di input specificata tutte le occorrenze di un'espressione regolare.
Matches(String, String)

Cerca nella stringa di input specificata tutte le occorrenze di un'espressione regolare specificata.

Matches(String, String, RegexOptions, TimeSpan)

Origine:
Regex.Match.cs
Origine:
Regex.Match.cs
Origine:
Regex.Match.cs
Origine:
Regex.Match.cs
Origine:
Regex.Match.cs

Cerca nella stringa di input specificata tutte le occorrenze di un'espressione regolare specificata, usando le opzioni di corrispondenza specificate e l'intervallo di timeout.

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

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 specificano le opzioni per la corrispondenza.

matchTimeout
TimeSpan

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

Valori restituiti

MatchCollection

Raccolta di Match oggetti trovati dalla ricerca. Se non vengono trovate corrispondenze, il metodo restituisce un oggetto raccolta vuoto.

Eccezioni

ArgumentException

Si è verificato un errore di analisi delle espressioni regolari.

ArgumentNullException

input o pattern è null.

ArgumentOutOfRangeException

options non è una combinazione bit per bit valida di RegexOptions valori. -oppure- matchTimeout è negativo, zero o maggiore di circa 24 giorni.

Commenti

Il Matches(String, String, RegexOptions, TimeSpan) metodo è simile al metodo , ad eccezione del Match(String, String, RegexOptions, TimeSpan) fatto che restituisce informazioni su tutte le corrispondenze trovate nella stringa di input, anziché una singola corrispondenza.

I metodi statici sono equivalenti Matches alla costruzione di un Regex oggetto con il criterio di espressione regolare specificato e la chiamata al metodo Matchesdi istanza .

Il Matches(String, String, RegexOptions, TimeSpan) metodo usa la valutazione differita per popolare l'oggetto restituito MatchCollection . L'accesso ai membri di questa raccolta, Count ad esempio e CopyTo(Array, Int32) fa sì che la raccolta venga popolata immediatamente. Per sfruttare i vantaggi della valutazione differita, scorrere la raccolta usando foreach.

A causa della valutazione differita, la chiamata al Matches(String, String, RegexOptions, TimeSpan) metodo non genera un'eccezione RegexMatchTimeoutException . Tuttavia, viene generata un'eccezione quando viene eseguita un'operazione sull'oggetto MatchCollection restituito da questo metodo, se un'operazione corrispondente supera l'intervallo di timeout specificato dal matchTimeout parametro .

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

Si applica a

Matches(String, String, RegexOptions)

Origine:
Regex.Match.cs
Origine:
Regex.Match.cs
Origine:
Regex.Match.cs
Origine:
Regex.Match.cs
Origine:
Regex.Match.cs

Cerca nella stringa di input specificata tutte le occorrenze di un'espressione regolare specificata, usando le opzioni di corrispondenza specificate.

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

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 specificano le opzioni per la corrispondenza.

Valori restituiti

MatchCollection

Raccolta di Match oggetti trovati dalla ricerca. Se non vengono trovate corrispondenze, il metodo restituisce un oggetto raccolta vuoto.

Eccezioni

ArgumentException

Si è verificato un errore di analisi delle espressioni regolari.

ArgumentNullException

input o pattern è null.

ArgumentOutOfRangeException

options non è una combinazione bit per bit valida di RegexOptions valori.

Commenti

Il Matches(String, String, RegexOptions) metodo è simile al metodo , ad eccezione del Match(String, String, RegexOptions) fatto che restituisce informazioni su tutte le corrispondenze trovate nella stringa di input, anziché una singola corrispondenza.

I metodi statici sono equivalenti Matches alla costruzione di un Regex oggetto con il criterio di espressione regolare specificato e la chiamata al metodo Matchesdi istanza .

Il Matches(String, String, RegexOptions) metodo usa la valutazione differita per popolare l'oggetto restituito MatchCollection . L'accesso ai membri di questa raccolta, Count ad esempio e CopyTo(Array, Int32) fa sì che la raccolta venga popolata immediatamente. Per sfruttare i vantaggi della valutazione differita, scorrere la raccolta usando foreach.

A causa della valutazione differita, la chiamata al Matches(String, String, RegexOptions) metodo non genera un'eccezione RegexMatchTimeoutException . Tuttavia, l'eccezione viene generata quando viene eseguita un'operazione sull'oggetto MatchCollection restituito da questo metodo, se un'operazione corrispondente supera l'intervallo di timeout.

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 il recupero di più corrispondenze di criteri è Matches(String, String, RegexOptions, TimeSpan), che consente di impostare l'intervallo di timeout.

Vedi anche

Si applica a

Matches(String, Int32)

Origine:
Regex.Match.cs
Origine:
Regex.Match.cs
Origine:
Regex.Match.cs
Origine:
Regex.Match.cs
Origine:
Regex.Match.cs

Cerca nella stringa di input specificata tutte le occorrenze di un'espressione regolare, a partire dalla posizione iniziale specificata nella stringa.

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

Parametri

input
String

Stringa in cui cercare una corrispondenza.

startat
Int32

Posizione del carattere nella stringa di input in corrispondenza della quale avviare la ricerca.

Valori restituiti

MatchCollection

Raccolta di Match oggetti trovati dalla ricerca. Se non vengono trovate corrispondenze, il metodo restituisce un oggetto raccolta vuoto.

Eccezioni

ArgumentNullException

input è null.

ArgumentOutOfRangeException

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

Commenti

Il Matches(String, Int32) metodo è simile al metodo , ad eccezione del Match(String, Int32) fatto che restituisce informazioni su tutte le corrispondenze trovate nella stringa di input, anziché una singola corrispondenza.

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

Il Matches(String, Int32) metodo usa la valutazione differita per popolare l'oggetto restituito MatchCollection . L'accesso ai membri di questa raccolta, Count ad esempio e CopyTo(Array, Int32) fa sì che la raccolta venga popolata immediatamente. Per sfruttare i vantaggi della valutazione differita, scorrere la raccolta usando foreach.

A causa della valutazione differita, la chiamata al Matches(String, Int32) metodo non genera un'eccezione RegexMatchTimeoutException . Tuttavia, l'eccezione viene generata quando viene eseguita un'operazione sull'oggetto MatchCollection restituito da questo metodo, se la MatchTimeout proprietà non InfiniteMatchTimeout è e un'operazione corrispondente supera l'intervallo di timeout.

Vedi anche

Si applica a

Matches(String)

Origine:
Regex.Match.cs
Origine:
Regex.Match.cs
Origine:
Regex.Match.cs
Origine:
Regex.Match.cs
Origine:
Regex.Match.cs

Cerca nella stringa di input specificata tutte le occorrenze di un'espressione regolare.

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

Parametri

input
String

Stringa in cui cercare una corrispondenza.

Valori restituiti

MatchCollection

Raccolta di Match oggetti trovati dalla ricerca. Se non vengono trovate corrispondenze, il metodo restituisce un oggetto raccolta vuoto.

Eccezioni

ArgumentNullException

input è null.

Commenti

Il Matches(String) metodo è simile al metodo , ad eccezione del Match(String) fatto che restituisce informazioni su tutte le corrispondenze trovate nella stringa di input, anziché una singola corrispondenza. La raccolta include solo corrispondenze e termina alla prima non corrispondenza.

Il Matches(String) metodo usa la valutazione differita per popolare l'oggetto restituito MatchCollection . L'accesso ai membri di questa raccolta, Count ad esempio e CopyTo(Array, Int32) fa sì che la raccolta venga popolata immediatamente. Per sfruttare i vantaggi della valutazione differita, scorrere la raccolta usando foreach.

A causa della valutazione differita, la chiamata al Matches(String) metodo non genera un'eccezione RegexMatchTimeoutException . Tuttavia, l'eccezione viene generata quando viene eseguita un'operazione sull'oggetto MatchCollection restituito da questo metodo, se la MatchTimeout proprietà non InfiniteMatchTimeout è e un'operazione corrispondente supera l'intervallo di timeout.

Vedi anche

Si applica a

Matches(String, String)

Origine:
Regex.Match.cs
Origine:
Regex.Match.cs
Origine:
Regex.Match.cs
Origine:
Regex.Match.cs
Origine:
Regex.Match.cs

Cerca nella stringa di input specificata tutte le occorrenze di un'espressione regolare specificata.

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

Parametri

input
String

Stringa in cui cercare una corrispondenza.

pattern
String

Modello di espressione regolare da trovare in corrispondenza.

Valori restituiti

MatchCollection

Raccolta di Match oggetti trovati dalla ricerca. Se non vengono trovate corrispondenze, il metodo restituisce un oggetto raccolta vuoto.

Eccezioni

ArgumentException

Si è verificato un errore di analisi delle espressioni regolari.

ArgumentNullException

input o pattern è null.

Commenti

Il Matches(String, String) metodo è simile al metodo , ad eccezione del Match(String, String) fatto che restituisce informazioni su tutte le corrispondenze trovate nella stringa di input, anziché una singola corrispondenza.

I metodi statici sono equivalenti Matches alla costruzione di un Regex oggetto con il criterio di espressione regolare specificato e la chiamata al metodo Matchesdi istanza .

Il Matches(String, String) metodo usa la valutazione differita per popolare l'oggetto restituito MatchCollection . L'accesso ai membri di questa raccolta, Count ad esempio e CopyTo(Array, Int32) fa sì che la raccolta venga popolata immediatamente. Per sfruttare i vantaggi della valutazione differita, scorrere la raccolta usando foreach.

A causa della valutazione differita, la chiamata al Matches(String, String) metodo non genera un'eccezione RegexMatchTimeoutException . Tuttavia, l'eccezione viene generata quando viene eseguita un'operazione sull'oggetto MatchCollection restituito da questo metodo, se un'operazione corrispondente supera l'intervallo di timeout.

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 il recupero di più corrispondenze di criteri è Matches(String, String, RegexOptions, TimeSpan), che consente di specificare l'intervallo di timeout.

Vedi anche

Si applica a