Regex.Matches Método

Definição

Espaço de Nomes:: System.Text.RegularExpressions

Assemblagens:: System.dll, System.Text.RegularExpressions.dll

Assemblagens:: netstandard.dll, System.Text.RegularExpressions.dll

Assemblagem:: System.Text.RegularExpressions.dll

Assemblagem:: System.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Pesquisa uma cadeia de caracteres de entrada para todas as ocorrências de uma expressão regular e retorna todas as correspondências.

Sobrecargas

Name	Description
Matches(String, String, RegexOptions, TimeSpan)	Pesquisa na cadeia de entrada especificada todas as ocorrências de uma expressão regular especificada, usando as opções de correspondência e o intervalo de tempo de espera especificados.
Matches(String, String, RegexOptions)	Pesquisa na cadeia de entrada especificada todas as ocorrências de uma expressão regular especificada, usando as opções de correspondência especificadas.
Matches(String, Int32)	Pesquisa na cadeia de entrada especificada todas as ocorrências de uma expressão regular, começando na posição inicial especificada na cadeia.
Matches(String)	Pesquisa na cadeia de entrada especificada todas as ocorrências de uma expressão regular.
Matches(String, String)	Pesquisa na cadeia de entrada especificada todas as ocorrências de uma expressão regular especificada.

Matches(String, String, RegexOptions, TimeSpan)

Origem:: Regex.Match.cs

Origem:: Regex.Match.cs

Origem:: Regex.Match.cs

Origem:: Regex.Match.cs

Origem:: Regex.Match.cs

Pesquisa na cadeia de entrada especificada todas as ocorrências de uma expressão regular especificada, usando as opções de correspondência e o intervalo de tempo de espera especificados.

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

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 especificam 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

MatchCollection

Uma coleção dos Match objetos encontrados na busca. Se não forem encontradas correspondências, o método devolve um objeto de coleção vazio.

Exceções

ArgumentException

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

ArgumentNullException

input ou pattern é null.

ArgumentOutOfRangeException

options não é uma combinação válida de RegexOptions valores bit a bit. -ou- matchTimeout é negativo, zero ou superior a aproximadamente 24 dias.

Observações

O Matches(String, String, RegexOptions, TimeSpan) método é semelhante ao Match(String, String, RegexOptions, TimeSpan) método, exceto que devolve informação sobre todas as correspondências encontradas na cadeia de entrada, em vez de uma única correspondência.

Os métodos estáticos Matches são equivalentes a construir um Regex objeto com o padrão de expressão regular especificado e chamar o método Matchesde instância .

O Matches(String, String, RegexOptions, TimeSpan) método utiliza avaliação preguiçosa para preencher o objeto devolvido MatchCollection . Aceder a membros desta coleção, como Count e CopyTo(Array, Int32) faz com que a coleção seja preenchida imediatamente. Para tirar partido da avaliação preguiçosa, itera a coleção usando foreach.

Devido à sua avaliação preguiçosa, chamar o Matches(String, String, RegexOptions, TimeSpan) método não lança uma RegexMatchTimeoutException exceção. No entanto, uma exceção é lançada quando uma operação é realizada no MatchCollection objeto devolvido por este método, se uma operação de correspondência exceder o intervalo de tempo especificado pelo matchTimeout parâmetro.

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

Aplica-se a

Matches(String, String, RegexOptions)

Origem:: Regex.Match.cs

Origem:: Regex.Match.cs

Origem:: Regex.Match.cs

Origem:: Regex.Match.cs

Origem:: Regex.Match.cs

Pesquisa na cadeia de entrada especificada todas as ocorrências de uma expressão regular especificada, usando as opções de correspondência especificadas.

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

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 especificam opções para correspondência.

Devoluções

MatchCollection

Uma coleção dos Match objetos encontrados na busca. Se não forem encontradas correspondências, o método devolve um objeto de coleção vazio.

Exceções

ArgumentException

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

ArgumentNullException

input ou pattern é null.

ArgumentOutOfRangeException

options não é uma combinação válida de RegexOptions valores bit a bit.

Observações

O Matches(String, String, RegexOptions) método é semelhante ao Match(String, String, RegexOptions) método, exceto que devolve informação sobre todas as correspondências encontradas na cadeia de entrada, em vez de uma única correspondência.

Os métodos estáticos Matches são equivalentes a construir um Regex objeto com o padrão de expressão regular especificado e chamar o método Matchesde instância .

O Matches(String, String, RegexOptions) método utiliza avaliação preguiçosa para preencher o objeto devolvido MatchCollection . Aceder a membros desta coleção, como Count e CopyTo(Array, Int32) faz com que a coleção seja preenchida imediatamente. Para tirar partido da avaliação preguiçosa, itera a coleção usando foreach.

Devido à sua avaliação preguiçosa, chamar o Matches(String, String, RegexOptions) método não lança uma RegexMatchTimeoutException exceção. No entanto, a exceção é lançada quando uma operação é realizada no MatchCollection objeto devolvido por este método, se uma operação de correspondência exceder o intervalo de time-out.

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 recuperar múltiplas correspondências de padrões é Matches(String, String, RegexOptions, TimeSpan), que permite definir o intervalo de time-out.

Ver também

Elementos da Linguagem de Expressões Regulares

Aplica-se a

Matches(String, Int32)

Origem:: Regex.Match.cs

Origem:: Regex.Match.cs

Origem:: Regex.Match.cs

Origem:: Regex.Match.cs

Origem:: Regex.Match.cs

Pesquisa na cadeia de entrada especificada todas as ocorrências de uma expressão regular, começando na posição inicial especificada na cadeia.

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

Parâmetros

input: String

A cadeia para procurar uma correspondência.

startat: Int32

A posição do carácter na cadeia de entrada onde se deve iniciar a pesquisa.

Devoluções

MatchCollection

Uma coleção dos Match objetos encontrados na busca. Se não forem encontradas correspondências, o método devolve um objeto de coleção vazio.

Exceções

ArgumentNullException

input é null.

ArgumentOutOfRangeException

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

Observações

O Matches(String, Int32) método é semelhante ao Match(String, Int32) método, exceto que devolve informação sobre todas as correspondências encontradas na cadeia de entrada, em vez de uma única correspondência.

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

O Matches(String, Int32) método utiliza avaliação preguiçosa para preencher o objeto devolvido MatchCollection . Aceder a membros desta coleção, como Count e CopyTo(Array, Int32) faz com que a coleção seja preenchida imediatamente. Para tirar partido da avaliação preguiçosa, itera a coleção usando foreach.

Devido à sua avaliação preguiçosa, chamar o Matches(String, Int32) método não lança uma RegexMatchTimeoutException exceção. No entanto, a exceção é lançada quando uma operação é realizada no MatchCollection objeto devolvido por este método, se a MatchTimeout propriedade não InfiniteMatchTimeout for e uma operação de correspondência exceder o intervalo de time-out.

Ver também

Elementos da Linguagem de Expressões Regulares

Aplica-se a

Matches(String)

Origem:: Regex.Match.cs

Origem:: Regex.Match.cs

Origem:: Regex.Match.cs

Origem:: Regex.Match.cs

Origem:: Regex.Match.cs

Pesquisa na cadeia de entrada especificada todas as ocorrências de uma expressão regular.

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

Parâmetros

input: String

A cadeia para procurar uma correspondência.

Devoluções

MatchCollection

Uma coleção dos Match objetos encontrados na busca. Se não forem encontradas correspondências, o método devolve um objeto de coleção vazio.

Exceções

ArgumentNullException

input é null.

Observações

O Matches(String) método é semelhante ao Match(String) método, exceto que devolve informação sobre todas as correspondências encontradas na cadeia de entrada, em vez de uma única correspondência. A coleção inclui apenas partidas e termina no primeiro não-jogo.

O Matches(String) método utiliza avaliação preguiçosa para preencher o objeto devolvido MatchCollection . Aceder a membros desta coleção, como Count e CopyTo(Array, Int32) faz com que a coleção seja preenchida imediatamente. Para tirar partido da avaliação preguiçosa, itera a coleção usando foreach.

Devido à sua avaliação preguiçosa, chamar o Matches(String) método não lança uma RegexMatchTimeoutException exceção. No entanto, a exceção é lançada quando uma operação é realizada no MatchCollection objeto devolvido por este método, se a MatchTimeout propriedade não InfiniteMatchTimeout for e uma operação de correspondência exceder o intervalo de time-out.

Ver também

Elementos da Linguagem de Expressões Regulares

Aplica-se a

Matches(String, String)

Origem:: Regex.Match.cs

Origem:: Regex.Match.cs

Origem:: Regex.Match.cs

Origem:: Regex.Match.cs

Origem:: Regex.Match.cs

Pesquisa na cadeia de entrada especificada todas as ocorrências de uma expressão regular especificada.

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

Parâmetros

input: String

A cadeia para procurar uma correspondência.

pattern: String

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

Devoluções

MatchCollection

Uma coleção dos Match objetos encontrados na busca. Se não forem encontradas correspondências, o método devolve um objeto de coleção vazio.

Exceções

ArgumentException

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

ArgumentNullException

input ou pattern é null.

Observações

O Matches(String, String) método é semelhante ao Match(String, String) método, exceto que devolve informação sobre todas as correspondências encontradas na cadeia de entrada, em vez de uma única correspondência.

Os métodos estáticos Matches são equivalentes a construir um Regex objeto com o padrão de expressão regular especificado e chamar o método Matchesde instância .

O Matches(String, String) método utiliza avaliação preguiçosa para preencher o objeto devolvido MatchCollection . Aceder a membros desta coleção, como Count e CopyTo(Array, Int32) faz com que a coleção seja preenchida imediatamente. Para tirar partido da avaliação preguiçosa, itera a coleção usando foreach.

Devido à sua avaliação preguiçosa, chamar o Matches(String, String) método não lança uma RegexMatchTimeoutException exceção. No entanto, a exceção é lançada quando uma operação é realizada no MatchCollection objeto devolvido por este método, se uma operação de correspondência exceder o intervalo de time-out.

Notas para Chamadores

Ver também

Elementos da Linguagem de Expressões Regulares

Aplica-se a

Comentários

Esta página foi útil?