Regex 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:
Regex.cs
Origem:
Regex.cs
Origem:
Regex.cs
Origem:
Regex.cs
Origem:
Regex.cs

Representa uma expressão regular imutável. Contém também métodos estáticos que permitem o uso de expressões regulares sem instanciar explicitamente um Regex.

public ref class Regex
public ref class Regex : System::Runtime::Serialization::ISerializable
public class Regex
public class Regex : System.Runtime.Serialization.ISerializable
[System.Serializable]
public class Regex : System.Runtime.Serialization.ISerializable
type Regex = class
type Regex = class
    interface ISerializable
[<System.Serializable>]
type Regex = class
    interface ISerializable
Public Class Regex
Public Class Regex
Implements ISerializable
Herança
Object
Regex
Derivado
Atributos
SerializableAttribute
Implementações
ISerializable

Observações

A classe Regex representa o .NET motor de expressões regulares. Pode ser usado para analisar rapidamente grandes quantidades de texto para encontrar padrões específicos de caracteres; extrair, editar, substituir ou eliminar substrings de texto; e adicionar as cadeias extraídas a uma coleção para gerar um relatório.

Construtores

Name Description
Regex()

Inicializa uma nova instância da Regex classe.
Regex(SerializationInfo, StreamingContext)
Obsoleto.

Inicializa uma nova instância da Regex classe usando dados serializados.
Regex(String, RegexOptions, TimeSpan)

Inicializa uma nova instância da Regex classe para a expressão regular especificada, com opções que modificam o padrão e um valor que especifica quanto tempo um método de correspondência de padrões deve tentar fazer correspondência antes de expirar.
Regex(String, RegexOptions)

Inicializa uma nova instância da Regex classe para a expressão regular especificada, com opções que modificam o padrão.
Regex(String)

Inicializa uma nova instância da Regex classe para a expressão regular especificada.

Campos

Name Description
capnames

Quando são usadas capturas nomeadas, os nomes das capturas dos mapas para o seu índice correspondente. Caso contrário, null.
caps

Quando as capturas são escassas, os números de captura dos mapas para o seu índice correspondente no array de captura. Caso contrário, null.
capsize

O número de grupos de captura definidos no padrão de expressão regular.
capslist

Quando as capturas são escassas ou são usadas capturas nomeadas, contém a lista ordenada dos nomes das capturas. Caso contrário, null.
factory

Uma fábrica usada para criar RegexRunner instâncias para executar a expressão regular.
InfiniteMatchTimeout

Especifica que uma operação de correspondência de padrões não deve expirar.
internalMatchTimeout

O tempo máximo que pode decorrer numa operação de correspondência de padrões antes de a operação expirar.
pattern

O padrão de expressão regular que foi passado ao construtor.
roptions

As opções de expressão regular que eram passadas ao construtor.

Propriedades

Name Description
CacheSize

Obtém ou define o número máximo de entradas na cache estática atual das instâncias de expressões regulares.
CapNames

Obtém ou define um dicionário que mapeia grupos capturadores nomeados para os seus valores de índice.
Caps

Obtém ou define um dicionário que mapeia grupos numerados de captura para os seus valores de índice.
MatchTimeout

Obtém o intervalo de tempo de espera da instância atual.
Options

Obtém as opções que foram passadas ao Regex construtor.
RightToLeft

Obtém um valor que indica se a expressão regular pesquisa da direita para a esquerda.

Métodos

Name Description
CompileToAssembly(RegexCompilationInfo[], AssemblyName, CustomAttributeBuilder[], String)
Obsoleto.

Compila um ou mais objetos especificados Regex e um ficheiro de recurso especificado para um assembly nomeado com os atributos especificados.
CompileToAssembly(RegexCompilationInfo[], AssemblyName, CustomAttributeBuilder[])
Obsoleto.

Compila um ou mais objetos especificados Regex para um assembly nomeado com os atributos especificados.
CompileToAssembly(RegexCompilationInfo[], AssemblyName)
Obsoleto.

Compila um ou mais objetos especificados Regex para uma assembly nomeada.
Count(ReadOnlySpan<Char>, Int32)

Pesquisa num intervalo de entrada todas as ocorrências de uma expressão regular e devolve o número de correspondências.
Count(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)

Pesquisa num intervalo de entrada todas as ocorrências de uma expressão regular e devolve o número de correspondências.
Count(ReadOnlySpan<Char>, String, RegexOptions)

Pesquisa num intervalo de entrada todas as ocorrências de uma expressão regular e devolve o número de correspondências.
Count(ReadOnlySpan<Char>, String)

Pesquisa num intervalo de entrada todas as ocorrências de uma expressão regular e devolve o número de correspondências.
Count(ReadOnlySpan<Char>)

Pesquisa num intervalo de entrada todas as ocorrências de uma expressão regular e devolve o número de correspondências.
Count(String, String, RegexOptions, TimeSpan)

Pesquisa numa cadeia de entrada todas as ocorrências de uma expressão regular e devolve o número de correspondências.
Count(String, String, RegexOptions)

Pesquisa numa cadeia de entrada todas as ocorrências de uma expressão regular e devolve o número de correspondências.
Count(String, String)

Pesquisa numa cadeia de entrada todas as ocorrências de uma expressão regular e devolve o número de correspondências.
Count(String)

Pesquisa numa cadeia de entrada todas as ocorrências de uma expressão regular e devolve o número de correspondências.
EnumerateMatches(ReadOnlySpan<Char>, Int32)

Pesquisa num intervalo de entrada todas as ocorrências de uma expressão regular e retorna a Regex.ValueMatchEnumerator para iterar sobre as correspondências.
EnumerateMatches(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)

Pesquisa num intervalo de entrada todas as ocorrências de uma expressão regular e retorna a Regex.ValueMatchEnumerator para iterar sobre as correspondências.
EnumerateMatches(ReadOnlySpan<Char>, String, RegexOptions)

Pesquisa num intervalo de entrada todas as ocorrências de uma expressão regular e retorna a Regex.ValueMatchEnumerator para iterar sobre as correspondências.
EnumerateMatches(ReadOnlySpan<Char>, String)

Pesquisa num intervalo de entrada todas as ocorrências de uma expressão regular e retorna a Regex.ValueMatchEnumerator para iterar sobre as correspondências.
EnumerateMatches(ReadOnlySpan<Char>)

Pesquisa num intervalo de entrada todas as ocorrências de uma expressão regular e retorna a Regex.ValueMatchEnumerator para iterar sobre as correspondências.
EnumerateSplits(ReadOnlySpan<Char>, Int32, Int32)

Procura num intervalo de entrada todas as ocorrências de uma expressão regular e retorna a Regex.ValueSplitEnumerator para iterar sobre as divisões em torno das correspondências.
EnumerateSplits(ReadOnlySpan<Char>, Int32)

Procura num intervalo de entrada todas as ocorrências de uma expressão regular e retorna a Regex.ValueSplitEnumerator para iterar sobre as divisões em torno das correspondências.
EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)

Procura num intervalo de entrada todas as ocorrências de uma expressão regular e retorna a Regex.ValueSplitEnumerator para iterar sobre as divisões em torno das correspondências.
EnumerateSplits(ReadOnlySpan<Char>, String, RegexOptions)

Procura num intervalo de entrada todas as ocorrências de uma expressão regular e retorna a Regex.ValueSplitEnumerator para iterar sobre as divisões em torno das correspondências.
EnumerateSplits(ReadOnlySpan<Char>, String)

Procura num intervalo de entrada todas as ocorrências de uma expressão regular e retorna a Regex.ValueSplitEnumerator para iterar sobre as divisões em torno das correspondências.
EnumerateSplits(ReadOnlySpan<Char>)

Procura num intervalo de entrada todas as ocorrências de uma expressão regular e retorna a Regex.ValueSplitEnumerator para iterar sobre as divisões em torno das correspondências.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
Escape(String)

Escapa a um conjunto mínimo de caracteres (, *, +, ?, |, {, [, (, ), ^, $, ., # e espaços em branco) substituindo-os pelos seus códigos de escape. Isto instrui o motor de expressão regular a interpretar estes caracteres literalmente em vez de como metacaracteres.
Finalize()

Este membro sobrepõe-se Finalize(), e pode estar disponível documentação mais completa nesse tópico.

Permite Object tentar libertar recursos e realizar outras operações de limpeza antes de ser Object recuperado por recolha de lixo.
GetGroupNames()

Devolve um array de nomes de grupos que capturam para a expressão regular.
GetGroupNumbers()

Devolve um array de números de grupo capturadores que correspondem a nomes de grupos num array.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
GroupNameFromNumber(Int32)

Recebe o nome do grupo que corresponde ao número de grupo especificado.
GroupNumberFromName(String)

Devolve o número do grupo que corresponde ao nome do grupo especificado.
InitializeReferences()
Obsoleto.

Usado por um Regex objeto gerado pelo CompileToAssembly(RegexCompilationInfo[], AssemblyName) método. Este método está obsoleto.
IsMatch(ReadOnlySpan<Char>, Int32)

Indica se a expressão regular especificada no Regex construtor encontra uma correspondência num espaço de entrada especificado, começando na posição especificada.
IsMatch(ReadOnlySpan<Char>, String, RegexOptions, TimeSpan)

Indica se a expressão regular especificada encontra uma correspondência no intervalo de entrada especificado, usando as opções de correspondência e o intervalo de tempo de espera especificados.
IsMatch(ReadOnlySpan<Char>, String, RegexOptions)

Indica se a expressão regular especificada encontra uma correspondência no espaço de entrada especificado, usando as opções de correspondência especificadas.
IsMatch(ReadOnlySpan<Char>, String)

Indica se a expressão regular especificada encontra uma correspondência no intervalo de entrada especificado.
IsMatch(ReadOnlySpan<Char>)

Indica se a expressão regular especificada no Regex construtor encontra uma correspondência num intervalo de entrada especificado.
IsMatch(String, Int32)

Indica se a expressão regular especificada no Regex construtor encontra uma correspondência na cadeia de entrada especificada, começando na posição inicial especificada na cadeia.
IsMatch(String, String, RegexOptions, TimeSpan)

Indica se a expressão regular especificada encontra uma correspondência na cadeia de entrada especificada, usando as opções de correspondência e o intervalo de time-out especificados.
IsMatch(String, String, RegexOptions)

Indica se a expressão regular especificada encontra uma correspondência na cadeia de entrada especificada, usando as opções de correspondência especificadas.
IsMatch(String, String)

Indica se a expressão regular especificada encontra correspondência na cadeia de entrada especificada.
IsMatch(String)

Indica se a expressão regular especificada no Regex construtor encontra correspondência numa cadeia de entrada 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, 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, 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, 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)

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

Pesquisa na cadeia de entrada especificada a primeira ocorrência da expressão regular especificada no Regex construtor.
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, 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, String)

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

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

Cria uma cópia superficial do atual Object.

(Herdado de Object)
Replace(String, MatchEvaluator, Int32, Int32)

Numa subcadeia de entrada especificada, substitui um número máximo especificado de cadeias que correspondem a um padrão de expressão regular por uma cadeia devolvida por um MatchEvaluator delegado.
Replace(String, MatchEvaluator, Int32)

Numa cadeia de entrada especificada, substitui um número máximo especificado de cadeias que correspondem a um padrão de expressão regular por uma cadeia devolvida por um MatchEvaluator delegado.
Replace(String, MatchEvaluator)

Numa cadeia de entrada especificada, substitui todas as cadeias que correspondem a uma expressão regular especificada por uma cadeia devolvida por um MatchEvaluator delegado.
Replace(String, String, Int32, Int32)

Numa subcadeia de entrada especificada, substitui um número máximo especificado de cadeias que correspondem a um padrão de expressão regular por uma cadeia de substituição especificada.
Replace(String, String, Int32)

Numa cadeia de entrada especificada, substitui um número máximo especificado de cadeias que correspondem a um padrão de expressão regular por uma cadeia de substituição especificada.
Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan)

Numa cadeia de entrada especificada, substitui todas as substrings que correspondem a uma expressão regular especificada por uma string devolvida por um MatchEvaluator delegado. Parâmetros adicionais especificam opções que modificam a operação de correspondência e um intervalo de time-out caso não seja encontrada correspondência.
Replace(String, String, MatchEvaluator, RegexOptions)

Numa cadeia de entrada especificada, substitui todas as cadeias que correspondem a uma expressão regular especificada por uma cadeia devolvida por um MatchEvaluator delegado. As opções especificadas modificam a operação de correspondência.
Replace(String, String, MatchEvaluator)

Numa cadeia de entrada especificada, substitui todas as cadeias que correspondem a uma expressão regular especificada por uma cadeia devolvida por um MatchEvaluator delegado.
Replace(String, String, String, RegexOptions, TimeSpan)

Numa cadeia de entrada especificada, substitui todas as cadeias que correspondem a uma expressão regular especificada por uma cadeia de substituição especificada. Parâmetros adicionais especificam opções que modificam a operação de correspondência e um intervalo de time-out caso não seja encontrada correspondência.
Replace(String, String, String, RegexOptions)

Numa cadeia de entrada especificada, substitui todas as cadeias que correspondem a uma expressão regular especificada por uma cadeia de substituição especificada. As opções especificadas modificam a operação de correspondência.
Replace(String, String, String)

Numa cadeia de entrada especificada, substitui todas as cadeias que correspondem a um padrão de expressão regular especificado por uma cadeia de substituição especificada.
Replace(String, String)

Em uma cadeia de caracteres de entrada especificada, substitui todas as cadeias de caracteres que correspondem a um padrão de expressão regular por uma cadeia de caracteres de substituição especificada.
Split(String, Int32, Int32)

Divide uma cadeia de entrada um número máximo especificado de vezes num array de subcades, nas posições definidas por uma expressão regular especificada no Regex construtor. A procura pelo padrão de expressão regular começa numa posição específica de carácter na cadeia de entrada.
Split(String, Int32)

Divide uma cadeia de entrada um número máximo especificado de vezes num array de subcades, nas posições definidas por uma expressão regular especificada no Regex construtor.
Split(String, String, RegexOptions, TimeSpan)

Divide uma cadeia de entrada numa matriz de subcadeias nas posições definidas por um padrão de expressão regular especificado. Parâmetros adicionais especificam opções que modificam a operação de correspondência e um intervalo de time-out caso não seja encontrada correspondência.
Split(String, String, RegexOptions)

Divide uma cadeia de entrada numa matriz de subcadeias nas posições definidas por um padrão de expressão regular especificado. As opções especificadas modificam a operação de correspondência.
Split(String, String)

Divide uma cadeia de entrada numa matriz de subcadeias nas posições definidas por um padrão de expressão regular.
Split(String)

Divide uma cadeia de entrada numa matriz de subcadeias nas posições definidas por um padrão de expressão regular especificado no Regex construtor.
ToString()

Devolve o padrão de expressão regular que foi passado para o Regex construtor.
Unescape(String)

Converte quaisquer caracteres escapados na cadeia de entrada.
UseOptionC()
Obsoleto.

É verdade se a Compiled opção estiver definida.
UseOptionR()
Obsoleto.

É verdade se a RightToLeft opção estiver definida.
ValidateMatchTimeout(TimeSpan)

Valida que o valor de timeout especificado para correspondência é válido. O intervalo válido é TimeSpan.Zero < matchTimeout <= Regex.MaximumMatchTimeout.

Implementações de Interface Explícita

Name Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Preenche um SerializationInfo objeto com os dados necessários para desserializar o objeto atual Regex .

Aplica-se a

Segurança de Thread

A Regex classe é imutável (apenas leitura) e segura para threads. Regex Os objetos podem ser criados em qualquer thread e partilhados entre threads. Para mais informações, consulte Segurança de Fios.

Ver também