Regex.IsMatch Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Indica se a expressão regular encontra uma correspondência na cadeia de caracteres de entrada.
Sobrecargas
| Nome | Description |
|---|---|
| IsMatch(String, String, RegexOptions, TimeSpan) |
Indica se a expressão regular especificada encontra uma correspondência na cadeia de caracteres de entrada especificada, usando as opções de correspondência especificadas e o intervalo de tempo limite. |
| 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 especificadas e o intervalo de tempo limite. |
| IsMatch(String, String, RegexOptions) |
Indica se a expressão regular especificada encontra uma correspondência na cadeia de caracteres 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 intervalo de entrada especificado, usando as opções de correspondência especificadas. |
| IsMatch(String, String) |
Indica se a expressão regular especificada encontra uma correspondência na cadeia de caracteres de entrada especificada. |
| IsMatch(ReadOnlySpan<Char>, Int32) |
Indica se a expressão regular especificada no Regex construtor encontra uma correspondência em um intervalo 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 caracteres de entrada especificada, começando na posição inicial especificada na cadeia de caracteres. |
| IsMatch(String) |
Indica se a expressão regular especificada no Regex construtor encontra uma correspondência em uma cadeia de caracteres de entrada especificada. |
| IsMatch(ReadOnlySpan<Char>) |
Indica se a expressão regular especificada no Regex construtor encontra uma correspondência em um intervalo de entrada especificado. |
IsMatch(String, String, RegexOptions, TimeSpan)
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
Indica se a expressão regular especificada encontra uma correspondência na cadeia de caracteres de entrada especificada, usando as opções de correspondência especificadas e o intervalo de tempo limite.
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 de caracteres a ser pesquisada por uma correspondência.
- pattern
- String
O padrão de expressão regular a ser correspondido.
- options
- RegexOptions
Uma combinação bit a bit dos valores de enumeração que fornecem opções para correspondência.
- matchTimeout
- TimeSpan
Um intervalo de tempo limite ou InfiniteMatchTimeout para indicar que o método não deve ter tempo limite.
Retornos
true se a expressão regular encontrar uma correspondência; caso contrário, false.
Exceções
Ocorreu um erro de análise de expressão regular.
input ou pattern é null.
options não é um valor válido RegexOptions .
-ou- matchTimeout é negativo, zero ou maior que aproximadamente 24 dias.
Ocorreu um tempo limite.
Comentários
O IsMatch(String, String, RegexOptions, TimeSpan) método normalmente é usado para validar uma cadeia de caracteres ou para garantir que uma cadeia de caracteres esteja em conformidade com um padrão específico sem recuperar essa cadeia de caracteres para manipulação subsequente. Para recuperar cadeias de caracteres correspondentes, chame o método ou Matches(String, String, RegexOptions, TimeSpan) o Match(String, String, RegexOptions, TimeSpan) método.
O método estático IsMatch(String, String, RegexOptions, TimeSpan) é equivalente a construir um Regex objeto com o padrão e as opções especificados e chamar o método de IsMatch(String) instância. O padrão é armazenado em cache para recuperação rápida pelo mecanismo de expressão regular.
O matchTimeout parâmetro especifica por quanto tempo um método de correspondência de padrões deve tentar encontrar uma correspondência antes de atingir o tempo limite. A configuração de um intervalo de tempo limite impede que expressões regulares que dependem do retrocesso excessivo apareçam para parar de responder quando processam a entrada que contém correspondências próximas. Se nenhuma correspondência for encontrada nesse intervalo de tempo, o método gerará uma RegexMatchTimeoutException exceção.
matchTimeout substitui qualquer valor de tempo limite padrão definido para o domínio do aplicativo no qual o método é executado.
Notas aos Chamadores
Recomendamos que você defina o matchTimeout parâmetro como um valor apropriado, como dois segundos. Se você desabilitar o tempo limite especificando InfiniteMatchTimeout, o mecanismo de expressão regular oferecerá um desempenho ligeiramente melhor. No entanto, você deve desabilitar os tempos limite apenas nas seguintes condições:
Quando a entrada processada por uma expressão regular é derivada de uma fonte conhecida e confiável ou consiste em texto estático. Isso exclui o texto que foi inserido dinamicamente pelos usuários.
Quando o padrão de expressão regular tiver sido testado minuciosamente para garantir que ele manipule com eficiência correspondências, não correspondências e correspondências próximas.
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.
Confira também
Aplica-se a
IsMatch(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- 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 especificadas e o intervalo de tempo limite.
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 intervalo para procurar uma correspondência.
- pattern
- String
O padrão de expressão regular a ser correspondido.
- options
- RegexOptions
Uma combinação bit a bit dos valores de enumeração que fornecem opções para correspondência.
- matchTimeout
- TimeSpan
Um intervalo de tempo limite ou InfiniteMatchTimeout para indicar que o método não deve ter tempo limite.
Retornos
true se a expressão regular encontrar uma correspondência; caso contrário, false.
Exceções
Ocorreu um erro de análise de expressão regular.
pattern é null.
Ocorreu um tempo limite.
options não é um valor válido RegexOptions -ou- matchTimeout é negativo, zero ou maior que aproximadamente 24 dias.
Aplica-se a
IsMatch(String, String, RegexOptions)
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
Indica se a expressão regular especificada encontra uma correspondência na cadeia de caracteres 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 de caracteres a ser pesquisada por uma correspondência.
- pattern
- String
O padrão de expressão regular a ser correspondido.
- options
- RegexOptions
Uma combinação bit a bit dos valores de enumeração que fornecem opções para correspondência.
Retornos
true se a expressão regular encontrar uma correspondência; caso contrário, false.
Exceções
Ocorreu um erro de análise de expressão regular.
input ou pattern é null.
options não é um valor válido RegexOptions .
Ocorreu um tempo limite.
Comentários
O IsMatch(String, String, RegexOptions) método normalmente é usado para validar uma cadeia de caracteres ou para garantir que uma cadeia de caracteres esteja em conformidade com um padrão específico sem recuperar essa cadeia de caracteres para manipulação subsequente. Para recuperar cadeias de caracteres correspondentes, chame o método ou Matches(String, String, RegexOptions) o Match(String, String, RegexOptions) método.
O método estático IsMatch(String, String, RegexOptions) é equivalente a construir um Regex objeto com o padrão e as opções especificados e chamar o método de IsMatch(String) instância. O padrão é armazenado em cache para recuperação rápida pelo mecanismo de expressão regular.
Notas aos Chamadores
Esse método atinge o tempo limite após um intervalo igual ao valor de tempo limite padrão do domínio do aplicativo no qual ele é chamado. Se um valor de tempo limite não tiver sido definido para o domínio do aplicativo, o valor InfiniteMatchTimeout, que impede o tempo limite do método, será usado. O método estático recomendado para verificar se há IsMatch(String, String, RegexOptions, TimeSpan)uma correspondência de padrão, que permite definir o intervalo de tempo limite.
Confira também
Aplica-se a
IsMatch(ReadOnlySpan<Char>, String, RegexOptions)
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- 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 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 intervalo para procurar uma correspondência.
- pattern
- String
O padrão de expressão regular a ser correspondido.
- options
- RegexOptions
Uma combinação bit a bit dos valores de enumeração que fornecem opções para correspondência.
Retornos
true se a expressão regular encontrar uma correspondência; caso contrário, false.
Exceções
Ocorreu um erro de análise de expressão regular.
pattern é null.
Ocorreu um tempo limite.
options não é um valor válido RegexOptions .
Aplica-se a
IsMatch(String, String)
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
Indica se a expressão regular especificada encontra uma correspondência na cadeia de caracteres 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 de caracteres a ser pesquisada por uma correspondência.
- pattern
- String
O padrão de expressão regular a ser correspondido.
Retornos
true se a expressão regular encontrar uma correspondência; caso contrário, false.
Exceções
Ocorreu um erro de análise de expressão regular.
input ou pattern é null.
Ocorreu um tempo limite.
Comentários
O IsMatch(String, String) método normalmente é usado para validar uma cadeia de caracteres ou para garantir que uma cadeia de caracteres esteja em conformidade com um padrão específico sem recuperar essa cadeia de caracteres para manipulação subsequente. Para recuperar cadeias de caracteres correspondentes, chame o método ou Matches(String, String) o Match(String, String) método.
O método estático IsMatch(String, String) é equivalente a construir um Regex objeto com o padrão especificado e chamar o método de IsMatch(String) instância. O padrão é armazenado em cache para recuperação rápida pelo mecanismo de expressão regular.
Notas aos Chamadores
Esse método atinge o tempo limite após um intervalo igual ao valor de tempo limite padrão do domínio do aplicativo no qual o método é chamado. Se um valor de tempo limite não tiver sido definido para o domínio do aplicativo, o valor InfiniteMatchTimeout, que impede o tempo limite do método, será usado. O método estático recomendado para verificar se há IsMatch(String, String, RegexOptions, TimeSpan)uma correspondência de padrão, que permite definir o intervalo de tempo limite.
Confira também
Aplica-se a
IsMatch(ReadOnlySpan<Char>, Int32)
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
Indica se a expressão regular especificada no Regex construtor encontra uma correspondência em um intervalo 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 intervalo para procurar uma correspondência.
- startat
- Int32
A posição do caractere baseado em zero na qual iniciar a pesquisa.
Retornos
true se a expressão regular encontrar uma correspondência; caso contrário, false.
Exceções
Ocorreu um tempo limite.
Aplica-se a
IsMatch(ReadOnlySpan<Char>, String)
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- 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 intervalo para procurar uma correspondência.
- pattern
- String
O padrão de expressão regular a ser correspondido.
Retornos
true se a expressão regular encontrar uma correspondência; caso contrário, false.
Exceções
Ocorreu um erro de análise de expressão regular.
pattern é null.
Ocorreu um tempo limite.
Aplica-se a
IsMatch(String, Int32)
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
Indica se a expressão regular especificada no Regex construtor encontra uma correspondência na cadeia de caracteres de entrada especificada, começando na posição inicial especificada na cadeia de caracteres.
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 de caracteres a ser pesquisada por uma correspondência.
- startat
- Int32
A posição do caractere na qual iniciar a pesquisa.
Retornos
true se a expressão regular encontrar uma correspondência; caso contrário, false.
Exceções
input é null.
startat é menor que zero ou maior que o comprimento de input.
Ocorreu um tempo limite.
Comentários
O IsMatch(String, Int32) método normalmente é usado para validar uma cadeia de caracteres ou para garantir que uma cadeia de caracteres esteja em conformidade com um padrão específico sem recuperar essa cadeia de caracteres para manipulação subsequente. Para recuperar cadeias de caracteres correspondentes, chame o método ou Matches(String, Int32) o Match(String, Int32) método.
Para obter mais detalhes sobre startat, consulte as observações para Match(String, Int32).
Confira também
Aplica-se a
IsMatch(String)
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
Indica se a expressão regular especificada no Regex construtor encontra uma correspondência em uma cadeia de caracteres 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 de caracteres a ser pesquisada por uma correspondência.
Retornos
true se a expressão regular encontrar uma correspondência; caso contrário, false.
Exceções
input é null.
Ocorreu um tempo limite.
Comentários
O IsMatch(String) método normalmente é usado para validar uma cadeia de caracteres ou para garantir que uma cadeia de caracteres esteja em conformidade com um padrão específico sem recuperar essa cadeia de caracteres para manipulação subsequente. Para determinar se uma ou mais cadeias de caracteres correspondem a um padrão de expressão regular e recuperá-las para manipulação subsequente, chame o Match(String) método ou Matches(String) o método.
A RegexMatchTimeoutException exceção será gerada se o tempo de execução da operação de correspondência exceder o intervalo de tempo limite especificado pelo Regex(String, RegexOptions, TimeSpan) construtor. Se você não definir um intervalo de tempo limite ao chamar o construtor, a exceção será gerada se a operação exceder qualquer valor de tempo limite estabelecido para o domínio do aplicativo no qual o Regex objeto é criado. Se nenhum tempo limite for definido na chamada do Regex construtor ou nas propriedades do domínio do aplicativo ou se o valor de tempo limite for InfiniteMatchTimeout, nenhuma exceção será gerada.
Confira também
Aplica-se a
IsMatch(ReadOnlySpan<Char>)
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
- Origem:
- Regex.Match.cs
Indica se a expressão regular especificada no Regex construtor encontra uma correspondência em um 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 intervalo para procurar uma correspondência.
Retornos
true se a expressão regular encontrar uma correspondência; caso contrário, false.
Exceções
Ocorreu um tempo limite.