Regex.Matches Método

Definição

Namespace:

System.Text.RegularExpressions

Assemblies:

netstandard.dll, System.Text.RegularExpressions.dll

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

Sobrecargas

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

Matches(String, String, RegexOptions, TimeSpan)

Origem:

Regex.Match.cs

Pesquisa a cadeia de caracteres de entrada especificada para todas as ocorrências de uma expressão regular especificada, usando as opções de correspondência especificadas e o intervalo de tempo limite.

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

MatchCollection

Uma coleção dos Match objetos encontrados pela pesquisa. Se nenhuma correspondência for encontrada, o método retornará um objeto de coleção vazio.

Exceções

ArgumentException

Ocorreu um erro de análise de expressão regular.

ArgumentNullException

input ou pattern é null.

ArgumentOutOfRangeException

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

Comentários

O Matches(String, String, RegexOptions, TimeSpan) método é semelhante ao Match(String, String, RegexOptions, TimeSpan) método, exceto que ele retorna informações sobre todas as correspondências encontradas na cadeia de caracteres 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 usa uma avaliação lenta para preencher o objeto retornado MatchCollection . Acessar membros dessa coleção, como Count e CopyTo(Array, Int32) fazer com que a coleção seja preenchida imediatamente. Para aproveitar a avaliação lenta, itera a coleção usando foreach.

Devido à sua avaliação lenta, chamar o Matches(String, String, RegexOptions, TimeSpan) método não gera uma RegexMatchTimeoutException exceção. No entanto, uma exceção é gerada quando uma operação é executada no MatchCollection objeto retornado por esse método, se uma operação de correspondência exceder o intervalo de tempo limite especificado pelo matchTimeout parâmetro.

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

• Elementos de linguagem de expressão regular

Matches(String, String, RegexOptions)

Origem:

Regex.Match.cs

Pesquisa a cadeia de caracteres de entrada especificada para 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 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 especificam opções para correspondência.

Retornos

MatchCollection

Uma coleção dos Match objetos encontrados pela pesquisa. Se nenhuma correspondência for encontrada, o método retornará um objeto de coleção vazio.

Exceções

ArgumentException

Ocorreu um erro de análise de expressão regular.

ArgumentNullException

input ou pattern é null.

ArgumentOutOfRangeException

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

Comentários

O Matches(String, String, RegexOptions) método é semelhante ao Match(String, String, RegexOptions) método, exceto que ele retorna informações sobre todas as correspondências encontradas na cadeia de caracteres 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 usa uma avaliação lenta para preencher o objeto retornado MatchCollection . Acessar membros dessa coleção, como Count e CopyTo(Array, Int32) fazer com que a coleção seja preenchida imediatamente. Para aproveitar a avaliação lenta, itera a coleção usando foreach.

Devido à sua avaliação lenta, chamar o Matches(String, String, RegexOptions) método não gera uma RegexMatchTimeoutException exceção. No entanto, a exceção é gerada quando uma operação é executada no MatchCollection objeto retornado por esse método, se uma operação de correspondência exceder o intervalo de tempo limite.

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 recuperar várias correspondências de padrão é Matches(String, String, RegexOptions, TimeSpan), o que permite definir o intervalo de tempo limite.

Confira também

• Elementos de linguagem de expressão regular

Matches(String, Int32)

Origem:

Regex.Match.cs

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

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 de caracteres a ser pesquisada por uma correspondência.

startat

Int32

A posição do caractere na cadeia de caracteres de entrada na qual iniciar a pesquisa.

Retornos

MatchCollection

Uma coleção dos Match objetos encontrados pela pesquisa. Se nenhuma correspondência for encontrada, o método retornará um objeto de coleção vazio.

Exceções

ArgumentNullException

input é null.

ArgumentOutOfRangeException

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

Comentários

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

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

O Matches(String, Int32) método usa uma avaliação lenta para preencher o objeto retornado MatchCollection . Acessar membros dessa coleção, como Count e CopyTo(Array, Int32) fazer com que a coleção seja preenchida imediatamente. Para aproveitar a avaliação lenta, itera a coleção usando foreach.

Devido à sua avaliação lenta, chamar o Matches(String, Int32) método não gera uma RegexMatchTimeoutException exceção. No entanto, a exceção é gerada quando uma operação é executada no MatchCollection objeto retornado por esse método, se a MatchTimeout propriedade não InfiniteMatchTimeout estiver e uma operação correspondente exceder o intervalo de tempo limite.

Confira também

• Elementos de linguagem de expressão regular

Matches(String)

Origem:

Regex.Match.cs

Pesquisa a cadeia de caracteres de entrada especificada para 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 de caracteres a ser pesquisada por uma correspondência.

Retornos

MatchCollection

Uma coleção dos Match objetos encontrados pela pesquisa. Se nenhuma correspondência for encontrada, o método retornará um objeto de coleção vazio.

Exceções

ArgumentNullException

input é null.

Comentários

O Matches(String) método é semelhante ao Match(String) método, exceto que ele retorna informações sobre todas as correspondências encontradas na cadeia de caracteres de entrada, em vez de uma única correspondência. A coleção inclui apenas correspondências e termina na primeira não correspondência.

O Matches(String) método usa uma avaliação lenta para preencher o objeto retornado MatchCollection . Acessar membros dessa coleção, como Count e CopyTo(Array, Int32) fazer com que a coleção seja preenchida imediatamente. Para aproveitar a avaliação lenta, itera a coleção usando foreach.

Devido à sua avaliação lenta, chamar o Matches(String) método não gera uma RegexMatchTimeoutException exceção. No entanto, a exceção é gerada quando uma operação é executada no MatchCollection objeto retornado por esse método, se a MatchTimeout propriedade não InfiniteMatchTimeout estiver e uma operação correspondente exceder o intervalo de tempo limite.

Confira também

• Elementos de linguagem de expressão regular

Matches(String, String)

Origem:

Regex.Match.cs

Pesquisa a cadeia de caracteres de entrada especificada para 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 de caracteres a ser pesquisada por uma correspondência.

pattern

String

O padrão de expressão regular a ser correspondido.

Retornos

MatchCollection

Uma coleção dos Match objetos encontrados pela pesquisa. Se nenhuma correspondência for encontrada, o método retornará um objeto de coleção vazio.

Exceções

ArgumentException

Ocorreu um erro de análise de expressão regular.

ArgumentNullException

input ou pattern é null.

Comentários

O Matches(String, String) método é semelhante ao Match(String, String) método, exceto que ele retorna informações sobre todas as correspondências encontradas na cadeia de caracteres 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 usa uma avaliação lenta para preencher o objeto retornado MatchCollection . Acessar membros dessa coleção, como Count e CopyTo(Array, Int32) fazer com que a coleção seja preenchida imediatamente. Para aproveitar a avaliação lenta, itera a coleção usando foreach.

Devido à sua avaliação lenta, chamar o Matches(String, String) método não gera uma RegexMatchTimeoutException exceção. No entanto, a exceção é gerada quando uma operação é executada no MatchCollection objeto retornado por esse método, se uma operação de correspondência exceder o intervalo de tempo limite.

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 recuperar várias correspondências de padrão é Matches(String, String, RegexOptions, TimeSpan), o que permite especificar o intervalo de tempo limite.

Confira também

• Elementos de linguagem de expressão regular