Match Classe

Definição

Namespace:
System.Text.RegularExpressions
Assemblies:
System.dll, System.Text.RegularExpressions.dll
Assemblies:
netstandard.dll, System.Text.RegularExpressions.dll
Assembly:
System.Text.RegularExpressions.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Origem:
Match.cs
Origem:
Match.cs
Origem:
Match.cs
Origem:
Match.cs
Origem:
Match.cs

Representa os resultados de uma única correspondência de expressão regular.

public ref class Match : System::Text::RegularExpressions::Group
public class Match : System.Text.RegularExpressions.Group
[System.Serializable]
public class Match : System.Text.RegularExpressions.Group
type Match = class
    inherit Group
[<System.Serializable>]
type Match = class
    inherit Group
Public Class Match
Inherits Group
Herança
Object
Capture
Group
Match
Atributos
SerializableAttribute

Comentários

A Match classe é imutável e não tem construtor público. Uma instância da Match classe é retornada pelo Match(String) método e representa a primeira correspondência de padrão em uma cadeia de caracteres. As correspondências subsequentes são representadas por Match objetos retornados pelo NextMatch() método. Além disso, um MatchCollection objeto que consiste em zero, um ou mais Match objetos é retornado pelo Matches(String) método.

Se o Matches(String) método não corresponder a um padrão de expressão regular em uma cadeia de caracteres de entrada, ele retornará um objeto vazio MatchCollection . Em seguida, você pode usar um foreach constructo para iterar sobre a coleção.

Se o Match(String) método não corresponder ao padrão de expressão regular, ele retornará um Match objeto igual a Empty. Você pode usar a Success propriedade para determinar se a correspondência foi bem-sucedida.

Se uma correspondência de padrão for bem-sucedida, a Value propriedade conterá a subcadeia de caracteres correspondente, a Index propriedade indicará a posição inicial baseada em zero da subcadeia de caracteres correspondente na cadeia de caracteres de entrada e a Length propriedade indicará o comprimento da subcadeia de caracteres correspondente na cadeia de caracteres de entrada.

Como uma única correspondência pode envolver vários grupos de captura, Match tem uma Groups propriedade que retorna o GroupCollection. A Match instância em si é equivalente ao primeiro objeto da coleção, em Match.Groups[0], que representa toda a correspondência.

Propriedades

Nome Description
Captures

Obtém uma coleção de todas as capturas correspondentes pelo grupo de captura, em ordem innermost-leftmost-first (ou innermost-rightmost-first order if the regular expression is modified with the option RightToLeft ). A coleção pode ter zero ou mais itens.

(Herdado de Group)
Empty

Obtém a correspondência vazia. Todas as correspondências com falha retornam essa correspondência vazia.
Groups

Obtém uma coleção de grupos correspondentes à expressão regular.
Index

Obtém a posição na cadeia de caracteres original em que o primeiro caractere da subcadeia de caracteres capturada é encontrado.

(Herdado de Capture)
Length

Obtém o comprimento da subcadeia de caracteres capturada.

(Herdado de Capture)
Name

Retorna o nome do grupo de captura representado pela instância atual.

(Herdado de Group)
Success

Obtém um valor que indica se a correspondência foi bem-sucedida.

(Herdado de Group)
Value

Obtém a subcadeia de caracteres capturada da cadeia de caracteres de entrada.

(Herdado de Capture)
ValueSpan

Obtém o intervalo capturado da cadeia de caracteres de entrada.

(Herdado de Capture)

Métodos

Nome Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
NextMatch()

Retorna um novo Match objeto com os resultados da próxima correspondência, começando na posição em que a última correspondência terminou (no caractere após o último caractere correspondente).
Result(String)

Retorna a expansão do padrão de substituição passado. Por exemplo, se o padrão de substituição for $1$2, Result(String) retornará a concatenação de Groups[1].Value e Groups[2].Value.
Synchronized(Match)

Retorna uma Match instância equivalente à fornecida que é segura para compartilhar entre vários threads.
ToString()

Recupera a subcadeia de caracteres capturada da cadeia de caracteres de entrada chamando a Value propriedade.

(Herdado de Capture)

Aplica-se a

Confira também