Regex.IsMatch Método

Definição

Espaço de Nomes:

System.Text.RegularExpressions

Assemblagens:

netstandard.dll, System.Text.RegularExpressions.dll

Indica se a expressão regular encontra uma correspondência na cadeia de entrada.

Sobrecargas

Name	Description
IsMatch(String, String, RegexOptions, TimeSpan)	Indica se a expressão regular especificada encontra uma correspondência na cadeia de entrada especificada, usando as opções de correspondência e o intervalo de time-out especificados.
IsMatch(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)	Indica se a expressão regular especificada encontra uma correspondência no intervalo de entrada especificado, usando as opções de correspondência e o intervalo de tempo de espera especificados.
IsMatch(String, String, RegexOptions)	Indica se a expressão regular especificada encontra uma correspondência na cadeia de entrada especificada, usando as opções de correspondência especificadas.
IsMatch(ReadOnlySpan<Char>, String, RegexOptions)	Indica se a expressão regular especificada encontra uma correspondência no espaço de entrada especificado, usando as opções de correspondência especificadas.
IsMatch(String, String)	Indica se a expressão regular especificada encontra correspondência na cadeia de entrada especificada.
IsMatch(ReadOnlySpan<Char>, Int32)	Indica se a expressão regular especificada no Regex construtor encontra uma correspondência num espaço de entrada especificado, começando na posição especificada.
IsMatch(ReadOnlySpan<Char>, String)	Indica se a expressão regular especificada encontra uma correspondência no intervalo de entrada especificado.
IsMatch(String, Int32)	Indica se a expressão regular especificada no Regex construtor encontra uma correspondência na cadeia de entrada especificada, começando na posição inicial especificada na cadeia.
IsMatch(String)	Indica se a expressão regular especificada no Regex construtor encontra correspondência numa cadeia de entrada especificada.
IsMatch(ReadOnlySpan<Char>)	Indica se a expressão regular especificada no Regex construtor encontra uma correspondência num intervalo de entrada especificado.

IsMatch(String, String, RegexOptions, TimeSpan)

Origem:

Regex.Match.cs

Indica se a expressão regular especificada encontra uma correspondência na cadeia de entrada especificada, usando as opções de correspondência e o intervalo de time-out especificados.

public:
 static bool IsMatch(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);

public static bool IsMatch(string input, string pattern, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);

static member IsMatch : string * string * System.Text.RegularExpressions.RegexOptions * TimeSpan -> bool

Public Shared Function IsMatch (input As String, pattern As String, options As RegexOptions, matchTimeout As TimeSpan) As Boolean

Parâmetros

input

String

A cadeia para procurar uma correspondência.

pattern

String

O padrão de expressão regular para corresponder.

options

RegexOptions

Uma combinação bit a bit dos valores de enumeração que fornece opções para correspondência.

matchTimeout

TimeSpan

Um intervalo de time-out, ou InfiniteMatchTimeout para indicar que o método não deve expirar.

Devoluções

Boolean

true se a expressão regular encontrar uma correspondência; caso contrário, false.

Exceções

ArgumentException

Ocorreu um erro de análise sintática de expressões regulares.

ArgumentNullException

input ou pattern é null.

ArgumentOutOfRangeException

options não é um valor válido RegexOptions . -ou- matchTimeout é negativo, zero ou superior a aproximadamente 24 dias.

RegexMatchTimeoutException

Houve um castigo.

Observações

O IsMatch(String, String, RegexOptions, TimeSpan) método é normalmente usado para validar uma cadeia ou para garantir que uma corda segue um determinado padrão sem ter de recuperar essa corda para manipulação posterior. Para recuperar cadeias correspondentes, chame o Match(String, String, RegexOptions, TimeSpan) método ou Matches(String, String, RegexOptions, TimeSpan) em vez disso.

O método estático IsMatch(String, String, RegexOptions, TimeSpan) é equivalente a construir um Regex objeto com o padrão e opções especificados e chamar o IsMatch(String) método de instância. O padrão é armazenado em cache para recuperação rápida pelo motor de expressão regular.

O matchTimeout parâmetro especifica quanto tempo um método de correspondência de padrões deve tentar encontrar uma correspondência antes de expirar. Definir um intervalo de tempo impede que expressões regulares que dependem de retrocessos excessivos pareçam deixar de responder quando processam entradas que contenham correspondências próximas. Se não for encontrada correspondência nesse intervalo de tempo, o método lança uma RegexMatchTimeoutException exceção. matchTimeout sobrepõe-se a qualquer valor de time-out padrão definido para o domínio de aplicação onde o método é executado.

Notas para Chamadores

Recomendamos que defina o matchTimeout parâmetro para um valor apropriado, como dois segundos. Se desativar os tempos de espera especificando InfiniteMatchTimeout, o motor de expressão regular oferece um desempenho ligeiramente melhor. No entanto, deve desativar os tempos de espera apenas nas seguintes condições:

• Quando a entrada processada por uma expressão regular é derivada de uma fonte conhecida e de confiança ou consiste em texto estático. Isto exclui texto que tenha sido introduzido dinamicamente pelos utilizadores.

• Quando o padrão de expressão regular foi cuidadosamente testado para garantir que lida eficientemente com correspondências, não correspondências e próximas correspondências.

• Quando o padrão de expressão regular não contém elementos de linguagem, conhecidos por causar retrocesso excessivo ao processar uma correspondência próxima.

Ver também

• Elementos da Linguagem de Expressões Regulares

IsMatch(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)

Origem:

Regex.Match.cs

Indica se a expressão regular especificada encontra uma correspondência no intervalo de entrada especificado, usando as opções de correspondência e o intervalo de tempo de espera especificados.

public:
 static bool IsMatch(ReadOnlySpan<char> input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);

public static bool IsMatch(ReadOnlySpan<char> input, string pattern, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);

static member IsMatch : ReadOnlySpan<char> * string * System.Text.RegularExpressions.RegexOptions * TimeSpan -> bool

Public Shared Function IsMatch (input As ReadOnlySpan(Of Char), pattern As String, options As RegexOptions, matchTimeout As TimeSpan) As Boolean

Parâmetros

input

ReadOnlySpan<Char>

O tempo para procurar uma correspondência.

pattern

String

O padrão de expressão regular para corresponder.

options

RegexOptions

Uma combinação bit a bit dos valores de enumeração que fornece opções para correspondência.

matchTimeout

TimeSpan

Um intervalo de time-out, ou InfiniteMatchTimeout para indicar que o método não deve expirar.

Devoluções

Boolean

true se a expressão regular encontrar uma correspondência; caso contrário, false.

Exceções

ArgumentException

Ocorreu um erro de análise sintática de expressões regulares.

ArgumentNullException

pattern é null.

RegexMatchTimeoutException

Houve um castigo.

ArgumentOutOfRangeException

options não é um valor válido RegexOptions -ou- matchTimeout é negativo, zero ou superior a aproximadamente 24 dias.

IsMatch(String, String, RegexOptions)

Origem:

Regex.Match.cs

Indica se a expressão regular especificada encontra uma correspondência na cadeia de entrada especificada, usando as opções de correspondência especificadas.

public:
 static bool IsMatch(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options);

public static bool IsMatch(string input, string pattern, System.Text.RegularExpressions.RegexOptions options);

static member IsMatch : string * string * System.Text.RegularExpressions.RegexOptions -> bool

Public Shared Function IsMatch (input As String, pattern As String, options As RegexOptions) As Boolean

Parâmetros

input

String

A cadeia para procurar uma correspondência.

pattern

String

O padrão de expressão regular para corresponder.

options

RegexOptions

Uma combinação bit a bit dos valores de enumeração que fornece opções para correspondência.

Devoluções

Boolean

true se a expressão regular encontrar uma correspondência; caso contrário, false.

Exceções

ArgumentException

Ocorreu um erro de análise sintática de expressões regulares.

ArgumentNullException

input ou pattern é null.

ArgumentOutOfRangeException

options não é um valor válido RegexOptions .

RegexMatchTimeoutException

Houve um castigo.

Observações

O IsMatch(String, String, RegexOptions) método é normalmente usado para validar uma cadeia ou para garantir que uma corda segue um determinado padrão sem ter de recuperar essa corda para manipulação posterior. Para recuperar cadeias correspondentes, chame o Match(String, String, RegexOptions) método ou Matches(String, String, RegexOptions) em vez disso.

O método estático IsMatch(String, String, RegexOptions) é equivalente a construir um Regex objeto com o padrão e opções especificados e chamar o IsMatch(String) método de instância. O padrão é armazenado em cache para recuperação rápida pelo motor de expressão regular.

Notas para Chamadores

Este método expira após um intervalo igual ao valor de tempo limite padrão do domínio de aplicação em que é chamado. Se não tiver sido definido um valor de time-out para o domínio de aplicação, utiliza-se o valor InfiniteMatchTimeout, que impede que o método expire. O método estático recomendado para verificar uma correspondência de padrão é IsMatch(String, String, RegexOptions, TimeSpan), que permite definir o intervalo de time-out.

Ver também

• Elementos da Linguagem de Expressões Regulares

IsMatch(ReadOnlySpan<Char>, String, RegexOptions)

Origem:

Regex.Match.cs

Indica se a expressão regular especificada encontra uma correspondência no espaço de entrada especificado, usando as opções de correspondência especificadas.

public:
 static bool IsMatch(ReadOnlySpan<char> input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options);

public static bool IsMatch(ReadOnlySpan<char> input, string pattern, System.Text.RegularExpressions.RegexOptions options);

static member IsMatch : ReadOnlySpan<char> * string * System.Text.RegularExpressions.RegexOptions -> bool

Public Shared Function IsMatch (input As ReadOnlySpan(Of Char), pattern As String, options As RegexOptions) As Boolean

Parâmetros

input

ReadOnlySpan<Char>

O tempo para procurar uma correspondência.

pattern

String

O padrão de expressão regular para corresponder.

options

RegexOptions

Uma combinação bit a bit dos valores de enumeração que fornece opções para correspondência.

Devoluções

Boolean

true se a expressão regular encontrar uma correspondência; caso contrário, false.

Exceções

ArgumentException

Ocorreu um erro de análise sintática de expressões regulares.

ArgumentNullException

pattern é null.

RegexMatchTimeoutException

Houve um castigo.

ArgumentOutOfRangeException

options não é um valor válido RegexOptions .

IsMatch(String, String)

Origem:

Regex.Match.cs

Indica se a expressão regular especificada encontra correspondência na cadeia de entrada especificada.

public:
 static bool IsMatch(System::String ^ input, System::String ^ pattern);

public static bool IsMatch(string input, string pattern);

static member IsMatch : string * string -> bool

Public Shared Function IsMatch (input As String, pattern As String) As Boolean

Parâmetros

input

String

A cadeia para procurar uma correspondência.

pattern

String

O padrão de expressão regular para corresponder.

Devoluções

Boolean

true se a expressão regular encontrar uma correspondência; caso contrário, false.

Exceções

ArgumentException

Ocorreu um erro de análise sintática de expressões regulares.

ArgumentNullException

input ou pattern é null.

RegexMatchTimeoutException

Houve um castigo.

Observações

O IsMatch(String, String) método é normalmente usado para validar uma cadeia ou para garantir que uma corda segue um determinado padrão sem ter de recuperar essa corda para manipulação posterior. Para recuperar cadeias correspondentes, chame o Match(String, String) método ou Matches(String, String) em vez disso.

O método estático IsMatch(String, String) é equivalente a construir um Regex objeto com o padrão especificado e chamar o IsMatch(String) método de instância. O padrão é armazenado em cache para recuperação rápida pelo motor de expressão regular.

Notas para Chamadores

Este método expira após um intervalo igual ao valor padrão de time-out do domínio de aplicação onde o método é chamado. Se não tiver sido definido um valor de time-out para o domínio de aplicação, utiliza-se o valor InfiniteMatchTimeout, que impede que o método expire. O método estático recomendado para verificar uma correspondência de padrão é IsMatch(String, String, RegexOptions, TimeSpan), que permite definir o intervalo de time-out.

Ver também

• Elementos da Linguagem de Expressões Regulares

IsMatch(ReadOnlySpan<Char>, Int32)

Origem:

Regex.Match.cs

Indica se a expressão regular especificada no Regex construtor encontra uma correspondência num espaço de entrada especificado, começando na posição especificada.

public:
 bool IsMatch(ReadOnlySpan<char> input, int startat);

public bool IsMatch(ReadOnlySpan<char> input, int startat);

member this.IsMatch : ReadOnlySpan<char> * int -> bool

Public Function IsMatch (input As ReadOnlySpan(Of Char), startat As Integer) As Boolean

Parâmetros

input

ReadOnlySpan<Char>

O tempo para procurar uma correspondência.

startat

Int32

A posição de carácter base zero a partir da qual se deve iniciar a pesquisa.

Devoluções

Boolean

true se a expressão regular encontrar uma correspondência; caso contrário, false.

Exceções

RegexMatchTimeoutException

Houve um castigo.

IsMatch(ReadOnlySpan<Char>, String)

Origem:

Regex.Match.cs

Indica se a expressão regular especificada encontra uma correspondência no intervalo de entrada especificado.

public:
 static bool IsMatch(ReadOnlySpan<char> input, System::String ^ pattern);

public static bool IsMatch(ReadOnlySpan<char> input, string pattern);

static member IsMatch : ReadOnlySpan<char> * string -> bool

Public Shared Function IsMatch (input As ReadOnlySpan(Of Char), pattern As String) As Boolean

Parâmetros

input

ReadOnlySpan<Char>

O tempo para procurar uma correspondência.

pattern

String

O padrão de expressão regular para corresponder.

Devoluções

Boolean

true se a expressão regular encontrar uma correspondência; caso contrário, false.

Exceções

ArgumentException

Ocorreu um erro de análise sintática de expressões regulares.

ArgumentNullException

pattern é null.

RegexMatchTimeoutException

Houve um castigo.

IsMatch(String, Int32)

Origem:

Regex.Match.cs

Indica se a expressão regular especificada no Regex construtor encontra uma correspondência na cadeia de entrada especificada, começando na posição inicial especificada na cadeia.

public:
 bool IsMatch(System::String ^ input, int startat);

public bool IsMatch(string input, int startat);

member this.IsMatch : string * int -> bool

Public Function IsMatch (input As String, startat As Integer) As Boolean

Parâmetros

input

String

A cadeia para procurar uma correspondência.

startat

Int32

A posição da personagem onde começar a busca.

Devoluções

Boolean

true se a expressão regular encontrar uma correspondência; caso contrário, false.

Exceções

ArgumentNullException

input é null.

ArgumentOutOfRangeException

startat é menor que zero ou maior que o comprimento de input.

RegexMatchTimeoutException

Houve um castigo.

Observações

O IsMatch(String, Int32) método é normalmente usado para validar uma cadeia ou para garantir que uma corda segue um determinado padrão sem ter de recuperar essa corda para manipulação posterior. Para recuperar cadeias correspondentes, chame o Match(String, Int32) método ou Matches(String, Int32) em vez disso.

Para mais detalhes sobre startat, veja as observações para Match(String, Int32).

Ver também

• Elementos da Linguagem de Expressões Regulares

IsMatch(String)

Origem:

Regex.Match.cs

Indica se a expressão regular especificada no Regex construtor encontra correspondência numa cadeia de entrada especificada.

public:
 bool IsMatch(System::String ^ input);

public bool IsMatch(string input);

member this.IsMatch : string -> bool

Public Function IsMatch (input As String) As Boolean

Parâmetros

input

String

A cadeia para procurar uma correspondência.

Devoluções

Boolean

true se a expressão regular encontrar uma correspondência; caso contrário, false.

Exceções

ArgumentNullException

input é null.

RegexMatchTimeoutException

Houve um castigo.

Observações

O IsMatch(String) método é normalmente usado para validar uma cadeia ou para garantir que uma corda segue um determinado padrão sem ter de recuperar essa corda para manipulação posterior. Para determinar se uma ou mais cadeias correspondem a um padrão de expressão regular e recuperá-las para manipulação posterior, chame o Match(String) método ou Matches(String) .

A exceção RegexMatchTimeoutException é lançada se o tempo de execução da operação correspondente exceder o intervalo de tempo limite especificado pelo construtor Regex(String, RegexOptions, TimeSpan). Se você não definir um intervalo de tempo limite ao chamar o construtor, a exceção será lançada se a operação exceder qualquer valor de tempo limite estabelecido para o domínio do aplicativo no qual o objeto Regex é criado. Se nenhum tempo limite for definido na chamada do construtor Regex ou nas propriedades do domínio do aplicativo, ou se o valor de tempo limite for InfiniteMatchTimeout, nenhuma exceção será lançada.

Ver também

• Elementos da Linguagem de Expressões Regulares

IsMatch(ReadOnlySpan<Char>)

Origem:

Regex.Match.cs

Indica se a expressão regular especificada no Regex construtor encontra uma correspondência num intervalo de entrada especificado.

public:
 bool IsMatch(ReadOnlySpan<char> input);

public bool IsMatch(ReadOnlySpan<char> input);

member this.IsMatch : ReadOnlySpan<char> -> bool

Public Function IsMatch (input As ReadOnlySpan(Of Char)) As Boolean

Parâmetros

input

ReadOnlySpan<Char>

O tempo para procurar uma correspondência.

Devoluções

Boolean

true se a expressão regular encontrar uma correspondência; caso contrário, false.

Exceções

RegexMatchTimeoutException

Houve um castigo.