RegexMatchTimeoutException Classe

Definição

public ref class RegexMatchTimeoutException : TimeoutException

public class RegexMatchTimeoutException : TimeoutException

[System.Serializable]
public class RegexMatchTimeoutException : TimeoutException

type RegexMatchTimeoutException = class
    inherit TimeoutException

type RegexMatchTimeoutException = class
    inherit TimeoutException
    interface ISerializable

[<System.Serializable>]
type RegexMatchTimeoutException = class
    inherit TimeoutException
    interface ISerializable

Public Class RegexMatchTimeoutException
Inherits TimeoutException

Herança

Object

Exception

TimeoutException

RegexMatchTimeoutException

Herança

Object

Exception

SystemException

TimeoutException

RegexMatchTimeoutException

Atributos

SerializableAttribute

Implementações

ISerializable

Exemplos

O exemplo a seguir ilustra duas abordagens possíveis para lidar com a RegexMatchTimeoutException exceção. Uma constante cujo valor é de dois segundos define o intervalo máximo de tempo limite. O Regex.IsMatch(String, String, RegexOptions, TimeSpan) método é inicialmente chamado com um intervalo de tempo limite de um segundo. Cada RegexMatchTimeoutException exceção faz com que o intervalo de tempo limite seja aumentado em um segundo e resulte em outra chamada para o Regex.IsMatch método se o intervalo de tempo limite atual for menor que o intervalo máximo de tempo limite. No entanto, se o intervalo de tempo limite atual exceder o intervalo máximo de tempo limite, o manipulador de exceção gravará informações no log de eventos e abandonará o processamento da expressão regular.

using System;
using System.ComponentModel;
using System.Diagnostics;
using System.Security;
using System.Text.RegularExpressions;
using System.Threading;

public class Example
{
   const int MaxTimeoutInSeconds = 2;
   
   public static void Main()
   {
      TimeSpan timeout = new TimeSpan(0, 0, 1);
      string input = "aaaaaaaaaaaaaaaaaaaaaa>";
      if (ValidateInput(input, timeout))
         // Perform some operation with valid input string.
         Console.WriteLine("'{0}' is a valid string.", input); 
   } 

   private static bool ValidateInput(string input, TimeSpan timeout)
   {
      string pattern = "(a+)+$";      
      try {
         return Regex.IsMatch(input, pattern, 
                              RegexOptions.IgnoreCase, timeout);
      }
      catch (RegexMatchTimeoutException e) {
         // Increase the timeout interval and retry.
         timeout = timeout.Add(new TimeSpan(0, 0, 1));
         Console.WriteLine("Changing the timeout interval to {0}", 
                           timeout); 
         if (timeout.TotalSeconds <= MaxTimeoutInSeconds) {
            // Pause for a short period.
            Thread.Sleep(250);
            return ValidateInput(input, timeout);
         }   
         else {
            Console.WriteLine("Timeout interval of {0} exceeded.", 
                              timeout);
            // Write to event log named RegexTimeouts
            try {
               if (! EventLog.SourceExists("RegexTimeouts"))
                  EventLog.CreateEventSource("RegexTimeouts", "RegexTimeouts");

               EventLog log = new EventLog("RegexTimeouts");
               log.Source = "RegexTimeouts";
               string msg = String.Format("Timeout after {0} matching '{1}' with '{2}.",
                                          e.MatchTimeout, e.Input, e.Pattern);
               log.WriteEntry(msg, EventLogEntryType.Error);
            }
            // Do nothing to handle the exceptions.
            catch (SecurityException) { }
            catch (InvalidOperationException) { }
            catch (Win32Exception) { }
            return false;
         }   
      }
   }
}
// The example writes to the event log and also displays the following output:
//       Changing the timeout interval to 00:00:02
//       Changing the timeout interval to 00:00:03
//       Timeout interval of 00:00:03 exceeded.

Imports System.ComponentModel
Imports System.Diagnostics
Imports System.Security
Imports System.Text.RegularExpressions
Imports System.Threading

Module Example
   Const MaxTimeoutInSeconds As Integer = 2
   
   Public Sub Main()
      Dim timeout As TimeSpan = New TimeSpan(0, 0, 1)
      
      Dim input As String = "aaaaaaaaaaaaaaaaaaaaaa>"
      If ValidateInput(input, timeout) Then
         ' Perform some operation with valid input string.
         Console.WriteLine("'{0}' is a valid string.", input) 
      End If
   End Sub 

   Private Function ValidateInput(input As String, 
                                  timeout As TimeSpan) As Boolean
      Dim pattern As String = "(a+)+$"      
      Try
         Return Regex.IsMatch(input, pattern, 
                              RegexOptions.IgnoreCase, timeout)
      Catch e As RegexMatchTimeoutException
         ' Increase the timeout interval and retry.
         timeout = timeout.Add(New TimeSpan(0, 0, 1))
         Console.WriteLine("Changing the timeout interval to {0}", 
                           timeout) 
         If timeout.TotalSeconds <= MaxTimeoutInSeconds Then
            ' Pause for a short interval.
            Thread.Sleep(250)
            Return ValidateInput(input, timeout)
         Else
            Console.WriteLine("Timeout interval of {0} exceeded.", 
                              timeout)
            ' Write to event log named RegexTimeouts
            Try
               If Not EventLog.SourceExists("RegexTimeouts") Then
                  EventLog.CreateEventSource("RegexTimeouts", "RegexTimeouts")
               End If   
               Dim log As New EventLog("RegexTimeouts")
               log.Source = "RegexTimeouts"
               Dim msg As String = String.Format("Timeout after {0} matching '{1}' with '{2}.",
                                                 e.MatchTimeout, e.Input, e.Pattern)
               log.WriteEntry(msg, EventLogEntryType.Error)
            ' Do nothing to handle the exceptions.
            Catch ex As SecurityException

            Catch ex As InvalidOperationException

            Catch ex As Win32Exception

            End Try   
            Return False
         End If   
      End Try
   End Function
End Module
' The example writes to the event log and also displays the following output:
'       Changing the timeout interval to 00:00:02
'       Changing the timeout interval to 00:00:03
'       Timeout interval of 00:00:03 exceeded.

Comentários

A presença de uma RegexMatchTimeoutException exceção geralmente indica uma das seguintes condições:

• O mecanismo de expressão regular está retrocedendo excessivamente enquanto tenta corresponder o texto de entrada ao padrão de expressão regular.

• O intervalo de tempo limite foi definido muito baixo, especialmente considerando a alta carga do computador.

A maneira como um manipulador de exceção lida com uma exceção depende da causa da exceção:

• Se o tempo limite resultar de retrocesso excessivo, seu manipulador de exceção deverá abandonar a tentativa de corresponder à entrada e informar ao usuário que ocorreu um tempo limite no método de correspondência de padrões de expressão regular. Se possível, as informações sobre o padrão de expressão regular, que está disponível na Pattern propriedade e a entrada que causou retrocesso excessivo, que está disponível na Input propriedade, devem ser registradas para que o problema possa ser investigado e o padrão de expressão regular modificado. Os tempos limite devido ao retrocesso excessivo são sempre reproduzidos.

• Se o tempo limite resultar na configuração do limite de tempo limite muito baixo, você poderá aumentar o intervalo de tempo limite e repetir a operação de correspondência. O intervalo de tempo limite atual está disponível na MatchTimeout propriedade. Quando uma RegexMatchTimeoutException exceção é lançada, o mecanismo de expressão regular mantém seu estado para que quaisquer invocações futuras retornem o mesmo resultado, como se a exceção não tivesse ocorrido. O padrão recomendado é aguardar um breve intervalo de tempo aleatório após a exceção ser lançada antes de chamar o método correspondente novamente. Isso pode ser repetido várias vezes. No entanto, o número de repetições deve ser pequeno caso o tempo limite seja causado pelo retrocesso excessivo.

O exemplo na próxima seção ilustra ambas as técnicas para lidar com um RegexMatchTimeoutException.

Construtores

Propriedades

Métodos

Eventos

Implantações explícitas de interface

Aplica-se a

Confira também

• Retrocesso em expressões regulares
• Práticas recomendadas para expressões regulares no .NET