Regex.Match Método

Definição

Espaço de Nomes:

System.Text.RegularExpressions

Assemblagens:

netstandard.dll, System.Text.RegularExpressions.dll

Procura numa cadeia de entrada uma subcadeia que corresponda a um padrão de expressão regular e devolve a primeira ocorrência como um único Match objeto.

Sobrecargas

Name	Descrição
Match(String)	Pesquisa na cadeia de entrada especificada a primeira ocorrência da expressão regular especificada no Regex construtor.
Match(String, Int32)	Pesquisa na cadeia de entrada a primeira ocorrência de uma expressão regular, começando na posição inicial especificada na cadeia.
Match(String, String)	Pesquisa na cadeia de entrada especificada a primeira ocorrência da expressão regular especificada.
Match(String, Int32, Int32)	Pesquisa na cadeia de entrada a primeira ocorrência de uma expressão regular, começando na posição inicial especificada e procurando apenas o número especificado de caracteres.
Match(String, String, RegexOptions)	Pesquisa na cadeia de entrada a primeira ocorrência da expressão regular especificada, usando as opções de correspondência especificadas.
Match(String, String, RegexOptions, TimeSpan)	Pesquisa na cadeia de entrada a primeira ocorrência da expressão regular especificada, usando as opções de correspondência e o intervalo de time-out especificados.

Match(String)

Origem:

Regex.Match.cs

Pesquisa na cadeia de entrada especificada a primeira ocorrência da expressão regular especificada no Regex construtor.

public:
 System::Text::RegularExpressions::Match ^ Match(System::String ^ input);

public System.Text.RegularExpressions.Match Match(string input);

member this.Match : string -> System.Text.RegularExpressions.Match

Public Function Match (input As String) As Match

Parâmetros

input

String

A cadeia para procurar uma correspondência.

Devoluções

Match

Um objeto que contém informações sobre o jogo.

Exceções

ArgumentNullException

input é null.

RegexMatchTimeoutException

Houve um castigo.

Observações

O Match(String) método devolve a primeira subcadeia que corresponde a um padrão de expressão regular numa cadeia de entrada.

Pode determinar se o padrão de expressão regular foi encontrado na cadeia de entrada verificando a propriedade do Success objeto devolvidoMatch. Se for encontrada uma correspondência, a propriedade do Value objeto devolvido Match contém a substring correspondente. Se nenhuma correspondência for encontrada, seu valor será Empty.

Este método devolve a primeira correspondência. Você pode recuperar correspondências subsequentes chamando repetidamente o método Match do objeto NextMatch() retornado. Também pode recuperar todas as correspondências numa única chamada de método chamando 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

• NextMatch()
• Linguagem de Expressão Regular - Referência Rápida

Match(String, Int32)

Origem:

Regex.Match.cs

Pesquisa na cadeia de entrada a primeira ocorrência de uma expressão regular, começando na posição inicial especificada na cadeia.

public:
 System::Text::RegularExpressions::Match ^ Match(System::String ^ input, int startat);

public System.Text.RegularExpressions.Match Match(string input, int startat);

member this.Match : string * int -> System.Text.RegularExpressions.Match

Public Function Match (input As String, startat As Integer) As Match

Parâmetros

input

String

A cadeia 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

Match

Um objeto que contém informações sobre o jogo.

Exceções

ArgumentNullException

input é null.

ArgumentOutOfRangeException

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

RegexMatchTimeoutException

Houve um castigo.

Observações

Para mais informações sobre startat, veja Observações suplementares da API para Regex.Match.

Ver também

• NextMatch()
• Linguagem de Expressão Regular - Referência Rápida

Match(String, String)

Origem:

Regex.Match.cs

Pesquisa na cadeia de entrada especificada a primeira ocorrência da expressão regular especificada.

public:
 static System::Text::RegularExpressions::Match ^ Match(System::String ^ input, System::String ^ pattern);

public static System.Text.RegularExpressions.Match Match(string input, string pattern);

static member Match : string * string -> System.Text.RegularExpressions.Match

Public Shared Function Match (input As String, pattern As String) As Match

Parâmetros

input

String

A cadeia para procurar uma correspondência.

pattern

String

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

Devoluções

Match

Um objeto que contém informações sobre o jogo.

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 método estático Match(String, String) é equivalente a construir um Regex objeto com o padrão especificado e chamar o método de instância Match(String) . O motor de expressão regular armazena o padrão em cache.

Pode determinar se o padrão de expressão regular foi encontrado na cadeia de entrada verificando a propriedade do Success objeto devolvidoMatch. Se for encontrada uma correspondência, a propriedade do Value objeto devolvido Match contém a substring correspondente. Se nenhuma correspondência for encontrada, seu valor será Empty.

Você pode recuperar correspondências subsequentes chamando repetidamente o método Match do objeto NextMatch() retornado. Você também pode recuperar todas as correspondências em uma única chamada de método chamando o método Matches(String, String).

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 uma correspondência de padrão é Match(String, String), que permite definir o intervalo de time-out.

Ver também

• NextMatch()
• Linguagem de Expressão Regular - Referência Rápida

Match(String, Int32, Int32)

Origem:

Regex.Match.cs

Pesquisa na cadeia de entrada a primeira ocorrência de uma expressão regular, começando na posição inicial especificada e procurando apenas o número especificado de caracteres.

public:
 System::Text::RegularExpressions::Match ^ Match(System::String ^ input, int beginning, int length);

public System.Text.RegularExpressions.Match Match(string input, int beginning, int length);

member this.Match : string * int * int -> System.Text.RegularExpressions.Match

Public Function Match (input As String, beginning As Integer, length As Integer) As Match

Parâmetros

input

String

A cadeia para procurar uma correspondência.

beginning

Int32

A posição de carácter baseada em zero na cadeia de entrada que define a posição mais à esquerda a ser pesquisada.

length

Int32

O número de caracteres na subcadeia a incluir na pesquisa.

Devoluções

Match

Um objeto que contém informações sobre o jogo.

Exceções

ArgumentNullException

input é null.

ArgumentOutOfRangeException

beginning é menor que zero ou maior que o comprimento de input. -ou- length é menor que zero ou superior ao comprimento de input. -ou- beginning + length - 1 identifica uma posição que está fora do intervalo de .input

RegexMatchTimeoutException

Houve um castigo.

Observações

O Match(String, Int32, Int32) método pesquisa a porção de input definida pelos beginning parâmetros e length para o padrão de expressão regular. beginning define sempre o índice do carácter mais à esquerda a incluir na pesquisa, e length define o número máximo de caracteres a pesquisar. Juntos, definem o alcance da busca. O comportamento é exatamente como se a entrada fosse efetivamente input.Substring(beginning, length), exceto que o índice de qualquer correspondência é contado relativamente ao início de input. Isto significa que quaisquer âncoras ou asserções de largura zero no início ou fim do padrão comportam-se como se não houvesse entrada fora deste intervalo.

Se a pesquisa proceder da esquerda para a direita (o padrão), o motor de expressões regulares pesquisa do carácter no índice beginning para o carácter no índice beginning + length - 1. Se o motor de expressões regulares foi instanciado usando a RightToLeft opção, o motor pesquisa desde o carácter no índice beginning + length - 1 até ao carácter no índice .beginning

Este método devolve a primeira correspondência encontrada dentro deste intervalo. Você pode recuperar correspondências subsequentes chamando repetidamente o método Match do objeto NextMatch() retornado.

Ver também

• NextMatch()
• Linguagem de Expressão Regular - Referência Rápida

Match(String, String, RegexOptions)

Origem:

Regex.Match.cs

Pesquisa na cadeia de entrada a primeira ocorrência da expressão regular especificada, usando as opções de correspondência especificadas.

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

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

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

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

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

Match

Um objeto que contém informações sobre o jogo.

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.

RegexMatchTimeoutException

Houve um castigo.

Observações

O método estático Match(String, String, RegexOptions) é equivalente a construir um Regex objeto com o Regex(String, RegexOptions) construtor e chamar o método da instância Match(String) .

Pode determinar se o padrão de expressão regular foi encontrado na cadeia de entrada verificando a propriedade do Success objeto devolvidoMatch. Você pode recuperar correspondências subsequentes chamando repetidamente o método Match do objeto NextMatch() retornado. Você também pode recuperar todas as correspondências em uma única chamada de método chamando o método Matches(String, String, RegexOptions).

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 uma correspondência de padrão é Match(String, String), que permite definir o intervalo de time-out.

Ver também

• NextMatch()
• Linguagem de Expressão Regular - Referência Rápida

Match(String, String, RegexOptions, TimeSpan)

Origem:

Regex.Match.cs

Pesquisa na cadeia de entrada a primeira ocorrência da expressão regular especificada, usando as opções de correspondência e o intervalo de time-out especificados.

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

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

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

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

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

Match

Um objeto que contém informações sobre o jogo.

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.

RegexMatchTimeoutException

Houve um castigo.

Observações

O método estático Match(String, String, RegexOptions, TimeSpan) é equivalente a construir um Regex objeto com o Regex(String, RegexOptions, TimeSpan) construtor e chamar o método da instância Match(String) .

Pode determinar se o padrão de expressão regular foi encontrado na cadeia de entrada verificando a propriedade do Success objeto devolvidoMatch. Você pode recuperar correspondências subsequentes chamando repetidamente o método Match do objeto NextMatch() retornado.

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

• Linguagem de Expressão Regular - Referência Rápida