Classe Regex

Per ulteriori informazioni su come utilizzare la classe Regex, vedere le seguenti sezioni:

• Regex VS. metodi di stringa

• Statico VS. i metodi di istanza

• Esecuzione di operazioni relative a espressioni regolari

• Definizione del valore di timeout

La classe System.String include numerosi metodi di ricerca e confronto che è possibile utilizzare per eseguire corrispondenze di modelli con testo. Ad esempio, i metodi String.Contains, String.EndsWith e String.StartsWith determinano se un'istanza di stringa contiene una sottostringa specificata; i metodi String.IndexOf, String.IndexOfAny, String.LastIndexOf e String.LastIndexOfAny restituiscono la posizione iniziale di una sottostringa specificata in una stringa. Utilizzare i metodi della classe System.String quando occorre cercare una stringa specifica. Utilizzare la classe Regex per cercare un modello specifico in una stringa. Per ulteriori informazioni ed esempi, vedere Espressioni regolari di .NET Framework.

Torna a Osservazioni

Dopo avere definito un modello di espressione regolare, è possibile fornire al motore delle espressioni regolari in due modi:

• Creando un'istanza di un oggetto Regex che rappresenta l'espressione regolare. A tal proposito, occorre passare il modello di espressione regolare a un costruttore Regex. Un oggetto Regex non è modificabile; quando si crea un'istanza di un oggetto Regex con un'espressione regolare, l'espressione regolare di quel oggetto non può essere modificata.

• Fornendo sia l'espressione regolare che il testo da cercare a un metodo static (Shared in Visual Basic) Regex. In questo modo, è possibile utilizzare un'espressione regolare senza creare esplicitamente un oggetto Regex.

Tutti i metodi di identificazione di modelli Regex includono sia overload statici che di istanza.

Il motore delle espressioni regolari deve compilare un particolare modello prima di poterlo utilizzare. Poiché gli oggetti Regex non sono modificabili, questa è una procedura unica che viene eseguita quando viene chiamato un metodo statico o un costruttore della classe Regex. Per eliminare la necessità di compilare ripetutamente una singola espressione regolare, il motore delle espressioni regolari consente di memorizzare nella cache le espressioni regolari compilate utilizzate in chiamate a metodi statici. Di conseguenza, i metodi di corrispondenza di modelli delle espressioni regolari offrono prestazioni paragonabili per i metodi statici e quelli di istanza.

Importante
Nelle versioni 1.0 e 1.1 di .NET Framework, tutte le espressioni regolari compilate, utilizzate nelle chiamate sia a metodi statici che di istanza, venivano memorizzate nella cache. A partire da .NET Framework 2.0 vengono memorizzate nella cache solo le espressioni regolari utilizzate nelle chiamate al metodo statico.

Tuttavia, la memorizzazione nella cache può influire negativamente sulle prestazioni nei due seguenti casi:

• Quando si utilizzano chiamate a metodi statici con un gran numero di espressioni regolari. Per impostazione predefinita, il motore delle espressioni regolari memorizza nella cache le 15 espressioni regolari statiche utilizzate più di recente. Se l'applicazione in uso utilizza più di 15 espressioni regolari statiche, alcune espressioni regolari devono essere compilate di nuovo. Per impedire questo ricompilazione, è possibile aumentare la proprietà Regex.CacheSize.

• Quando viene creata un'istanza Regex nuovo oggetto con le espressioni regolari che erano state compilate. Ad esempio, il codice seguente viene definita un'espressione regolare per individuare le parole duplicate in un flusso di testo. Sebbene nell'esempio venga utilizzata una singola espressione regolare, viene creata l'istanza di un nuovo oggetto Regex per elaborare ciascuna riga di testo. Il risultato è la ricompilazione dell'espressione regolare con ciascuna iterazione del ciclo.

  C#

  VB

  Copia

  
  StreamReader sr = new StreamReader(filename);
  string input;
  string pattern = @"\b(\w+)\s\1\b";
  while (sr.Peek() >= 0)
  {
     input = sr.ReadLine();
     Regex rgx = new Regex(pattern, RegexOptions.IgnoreCase);
     MatchCollection matches = rgx.Matches(input);
     if (matches.Count > 0)
     {
        Console.WriteLine("{0} ({1} matches):", input, matches.Count);
        foreach (Match match in matches)
           Console.WriteLine("   " + match.Value);
     }
  }
  sr.Close();   
  
  
  

  Per impedire la ricompilazione, è necessario creare un'istanza di un singolo oggetto Regex accessibile al codice che lo richiede, come illustrato nell'esempio di.

  C#

  VB

  Copia

  
  StreamReader sr = new StreamReader(filename);
  string input;
  string pattern = @"\b(\w+)\s\1\b";
  Regex rgx = new Regex(pattern, RegexOptions.IgnoreCase);
  
  while (sr.Peek() >= 0)
  {
     input = sr.ReadLine();
     MatchCollection matches = rgx.Matches(input);
     if (matches.Count > 0)
     {
        Console.WriteLine("{0} ({1} matches):", input, matches.Count);
        foreach (Match match in matches)
           Console.WriteLine("   " + match.Value);
     }
  }
  sr.Close();   
  
  
  

Torna a Osservazioni

Che si decida di creare un'istanza di un oggetto Regex e chiamarne i metodi o di chiamare i metodi statici, la classe Regex offre le seguenti funzionalità di corrispondenza di modelli:

• Convalida di una corrispondenza. Il metodo IsMatch consente di determinare se è presente una corrispondenza.

• Recupero di una singola corrispondenza. Il metodo Match consente di recuperare un oggetto Match che rappresenta la prima corrispondenza in una stringa o in una parte di stringa. Le corrispondenze successive possono essere recuperate chiamando il metodo Match.NextMatch.

• Recupero di tutte le corrispondenze. Il metodo Matches viene chiamato per recuperare un oggetto System.Text.RegularExpressions.MatchCollection che rappresenta tutte le corrispondenze trovate in una stringa o in una parte di stringa.

• Sostituzione di testo corrispondente. Il metodo Replace può essere chiamato per sostituire testo corrispondente. Il testo di sostituzione può essere definito anche da un'espressione regolare. Inoltre, alcuni dei metodi Replace includono un parametro MatchEvaluator che consente di definire a livello di codice il testo di sostituzione.

• Creazione di una matrice di stringhe che è formata da parti di una stringa di input. Il metodo Split viene chiamato per dividere una stringa di input in corrispondenza di posizioni che sono definite dall'espressione regolare.

Oltre a questi metodi di corrispondenza di modelli, la classe Regex include numerosi metodi finalizzati a scopi precisi:

• Il metodo Escape effettua l'escape di caratteri che possono essere interpretati come operatori di espressioni regolari in un'espressione regolare o in una stringa di input.

• Il metodo Unescape consente di rimuovere questi caratteri di escape.

• Il metodo CompileToAssembly crea un assembly che contiene espressioni regolari predefinite. .NET Framework contiene esempi di questi assembly per usi specifici nello spazio dei nomi System.Web.RegularExpressions.

Torna a Osservazioni

.NET Framework supporta un linguaggio delle espressioni regolari completo che fornisce la potenza e flessibilità sostanziali nei criteri di ricerca. Tuttavia, la potenza e flessibilità presentano anche alcuni svantaggi: il rischio delle numerose. Le espressioni regolari che eseguono correttamente sorprendente sono facili da creare. In alcuni casi, le operazioni di espressione regolare che si basano su utilizzo eccessivo del backtracking può sembrare non rispondere quando elaborano il testo che corrisponde quasi al modello di espressione regolare. Per ulteriori informazioni sul motore delle espressioni regolari di .NET Framework, vedere Dettagli sul funzionamento delle espressioni regolari. Per ulteriori informazioni sull'utilizzo eccessivo del backtracking, vedere Backtracking.

A partire da .NET Framework 4.5, è possibile definire un intervallo di timeout per le corrispondenze di espressione regolare. Se il motore delle espressioni regolari non può identificare una corrispondenza all'interno di questo intervallo di tempo, l'operazione corrispondente genera un'eccezione RegexMatchTimeoutException. Nella maggior parte dei casi, si impedisce il motore delle espressioni regolari da spreco della potenza di elaborazione tenta di trovare una corrispondenza con il testo che corrisponde quasi al modello di espressione regolare. Potrebbe anche indicare, tuttavia, che l'intervallo di timeout è stato impostato troppo basso, o al caricamento del computer corrente può causare una riduzione delle prestazioni globali.

Come gestire l'eccezione dipende dalla causa di un'eccezione. Se l'eccezione si verifica poiché l'intervallo di timeout viene impostato troppo basso o a causa del sovraccarico di caricamento del computer, è possibile aumentare l'intervallo di timeout e ritentare l'operazione corrispondente. Se l'eccezione si verifica perché l'espressione regolare si basa su utilizzo eccessivo del backtracking, è possibile presupporre che una corrispondenza non esiste e, facoltativamente, è possibile registrare informazioni utili per modificare il modello di espressione regolare.

È possibile impostare un intervallo di timeout chiamando il costruttore Regex(String, RegexOptions, TimeSpan) quando viene creata un'istanza di un oggetto di espressione regolare. Per i metodi statici, è possibile impostare un intervallo di timeout chiamando un overload del metodo corrispondente con un parametro matchTimeout. Se non si imposta un valore di timeout in modo esplicito, il valore di timeout predefinito è determinato come segue:

• L'utilizzo dell'applicazione il valore di timeout, se presente. Può trattarsi di qualsiasi valore di timeout applicato al dominio applicazione in cui l'oggetto Regex viene creata un'istanza o la chiamata al metodo statico viene eseguita. È possibile impostare sull'intera il valore di timeout chiamando il metodo AppDomain.SetData per assegnare la rappresentazione di stringa di un valore TimeSpan alla proprietà “di REGEX_DEFAULT_MATCH_TIMEOUT„.

• Utilizzando il valore InfiniteMatchTimeout, se non esplicitamente il valore di timeout è stato impostato.

Importante
Si consiglia di impostare un valore di timeout in tutte le operazioni di criteri di ricerca di espressioni regolari. Per ulteriori informazioni, vedere Procedure consigliate per le espressioni regolari in .NET Framework.

Torna a Osservazioni