Match Classe

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

Observações

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

Se o Matches(String) método não corresponder a um padrão de expressão regular numa cadeia de entrada, devolve um objeto vazio MatchCollection . Depois podes usar um foreach construto para iterar sobre a coleção.

Se o Match(String) método não corresponder ao padrão de expressão regular, devolve um Match objeto igual a Empty. 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 contém a subcadeia emparelhada, a Index propriedade indica a posição inicial baseada em zero da subcadeia emparelhada na cadeia de entrada, e a Length propriedade indica o comprimento da subcadeia emparelhada na cadeia de entrada.

Como uma única correspondência pode envolver múltiplos grupos de captura, Match tem uma Groups propriedade que devolve 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

Name Description
Captures

Obtém uma coleção de todas as capturas emparelhadas pelo grupo capturador, em ordem mais à esquerda (ou ordem mais à direita se a expressão regular for modificada com a RightToLeft opção). A coleção pode não conter nenhum ou mais itens.

(Herdado de Group)
Empty

Fica com o fósforo vazio. Todos os matches falhados devolvem este fósforo vazio.
Groups

Obtém uma coleção de grupos correspondidos pela expressão regular.
Index

Obtém a posição na cadeia original onde se encontra o primeiro carácter da subcadeia capturada.

(Herdado de Capture)
Length

Obtém o comprimento da subcorda capturada.

(Herdado de Capture)
Name

Devolve o nome do grupo capturador representado pela instância atual.

(Herdado de Group)
Success

Recebe um valor que indica se a correspondência foi bem-sucedida.

(Herdado de Group)
Value

Obtém a substring capturada da string de entrada.

(Herdado de Capture)
ValueSpan

Obtém o span capturado da cadeia de entrada.

(Herdado de Capture)

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
NextMatch()

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

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

Devolve uma Match instância equivalente à fornecida que é segura para partilhar entre múltiplos threads.
ToString()

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

(Herdado de Capture)

Aplica-se a

Ver também