Regex.Replace Método

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

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

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

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

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

Parâmetros

Devoluções

Uma nova cadeia que é idêntica à cadeia de entrada, exceto que a cadeia de substituição substitui cada cadeia correspondente. Se pattern não for correspondido na instância atual, o método devolve a instância atual inalterada.

Exceções

Observações

Os métodos estáticos Replace(String, String, String, RegexOptions) são equivalentes a construir um Regex objeto com o padrão de expressão regular especificado e chamar o método Replace(String, String)de instância .

O replacement parâmetro especifica a cadeia que substitui cada correspondência em input. replacement pode consistir em qualquer combinação de texto literal e substituições. As substituições são os únicos elementos de linguagem de expressão regular reconhecidos num padrão de substituição.

Como o método retorna input inalterado se não houver correspondência, pode usar o ReferenceEquals(Object, Object) método para determinar se o método fez alguma substituição.

Se especificar RightToLeft para o options parâmetro, a pesquisa por correspondências começa no final da cadeia de entrada e move-se para a esquerda; caso contrário, a pesquisa começa no início da cadeia de entrada e move-se para a direita.

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

Ver também

• RegexOptions
• Substituições em expressões regulares
• Elementos da Linguagem de Expressões Regulares

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

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

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

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

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

Parâmetros

Devoluções

Uma nova cadeia que é idêntica à cadeia de entrada, exceto que a cadeia de substituição substitui cada cadeia correspondente. Se pattern não for correspondido na instância atual, o método devolve a instância atual inalterada.

Exceções

Observações

Os métodos estáticos Replace(String, String, String, RegexOptions, TimeSpan) são equivalentes a construir um Regex objeto com o padrão de expressão regular especificado e chamar o método Replace(String, String)de instância .

O replacement parâmetro especifica a cadeia que substitui cada correspondência em input. replacement pode consistir em qualquer combinação de texto literal e substituições. As substituições são os únicos elementos de linguagem de expressão regular reconhecidos num padrão de substituição.

Como o método retorna input inalterado se não houver correspondência, pode usar o ReferenceEquals(Object, Object) método para determinar se o método fez alguma substituição.

Se especificar RightToLeft para o options parâmetro, a pesquisa por correspondências começa no final da cadeia de entrada e move-se para a esquerda; caso contrário, a pesquisa começa no início da cadeia de entrada e move-se para a direita.

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

• RegexOptions
• Substituições em expressões regulares
• Elementos da Linguagem de Expressões Regulares
• Retrocesso em expressões regulares
• Melhores práticas para expressões regulares em .NET

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

public:
 System::String ^ Replace(System::String ^ input, System::Text::RegularExpressions::MatchEvaluator ^ evaluator, int count, int startat);

public string Replace(string input, System.Text.RegularExpressions.MatchEvaluator evaluator, int count, int startat);

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

Public Function Replace (input As String, evaluator As MatchEvaluator, count As Integer, startat As Integer) As String

Parâmetros

Devoluções

Uma nova cadeia que é idêntica à cadeia de entrada, exceto que uma corda de substituição substitui cada cadeia correspondente. Se o padrão de expressão regular não for correspondido na instância atual, o método devolve a instância atual inalterada.

Exceções

Observações

Para mais detalhes sobre startat, veja a secção Observações de Match(String, Int32).

O método passa os primeiros countMatch objetos ao evaluator delegado.

Ver também

• MatchEvaluator
• Substituições em expressões regulares
• Linguagem de Expressão Regular - Referência Rápida

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

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

public static string Replace(string input, string pattern, System.Text.RegularExpressions.MatchEvaluator evaluator, System.Text.RegularExpressions.RegexOptions options);

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

Public Shared Function Replace (input As String, pattern As String, evaluator As MatchEvaluator, options As RegexOptions) As String

Parâmetros

Devoluções

Uma nova cadeia que é idêntica à cadeia de entrada, exceto que uma corda de substituição substitui cada cadeia correspondente. Se pattern não for correspondido na instância atual, o método devolve a instância atual inalterada.

Exceções

Observações

Este método é útil para substituir uma correspondência de expressões regulares se alguma das seguintes condições for verdadeira: a cadeia de substituição não pode ser facilmente especificada por um padrão de substituição de expressão regular, a cadeia de substituição resulta do processamento da cadeia emparelhada, ou a cadeia de substituição resulta do processamento condicional.

O método é equivalente a chamar o Matches(String, String) método e passar cada Match objeto devolvido MatchCollection ao evaluator delegado.

Como o método retorna input inalterado se não houver correspondência, pode usar o ReferenceEquals(Object, Object) método para determinar se o método fez alguma substituição.

Se especificar RightToLeft para o options parâmetro, a pesquisa por correspondências começa no final da cadeia de entrada e move-se para a esquerda; caso contrário, a pesquisa começa no início da cadeia de entrada e move-se para a direita.

Ver também

• MatchEvaluator
• RegexOptions
• Substituições em expressões regulares
• Elementos da Linguagem de Expressões Regulares

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

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

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

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

Public Shared Function Replace (input As String, pattern As String, evaluator As MatchEvaluator, options As RegexOptions, matchTimeout As TimeSpan) As String

Parâmetros

Devoluções

Uma nova cadeia que é idêntica à cadeia de entrada, exceto que uma corda de substituição substitui cada cadeia correspondente. Se pattern não for correspondido na instância atual, o método devolve a instância atual inalterada.

Exceções

Observações

Este método é útil para substituir uma correspondência de expressões regulares se alguma das seguintes condições for verdadeira: a cadeia de substituição não pode ser facilmente especificada por um padrão de substituição de expressão regular, a cadeia de substituição resulta do processamento da cadeia emparelhada, ou a cadeia de substituição resulta do processamento condicional.

O método é equivalente a chamar o Matches(String, String) método e passar cada Match objeto devolvido MatchCollection ao evaluator delegado.

Como o método retorna input inalterado se não houver correspondência, pode usar o ReferenceEquals(Object, Object) método para determinar se o método fez alguma substituição.

Se especificar RightToLeft para o options parâmetro, a pesquisa por correspondências começa no final da cadeia de entrada e move-se para a esquerda; caso contrário, a pesquisa começa no início da cadeia de entrada e move-se para a direita.

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. matchTimeout Sobrepõe 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

• RegexOptions
• Substituições em expressões regulares
• Elementos da Linguagem de Expressões Regulares
• Retrocesso em expressões regulares
• Melhores práticas para expressões regulares em .NET

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

public:
 System::String ^ Replace(System::String ^ input, System::String ^ replacement, int count, int startat);

public string Replace(string input, string replacement, int count, int startat);

member this.Replace : string * string * int * int -> string

Public Function Replace (input As String, replacement As String, count As Integer, startat As Integer) As String

Parâmetros

Devoluções

Uma nova cadeia que é idêntica à cadeia de entrada, exceto que a cadeia de substituição substitui cada cadeia correspondente. Se o padrão de expressão regular não for correspondido na instância atual, o método devolve a instância atual inalterada.

Exceções

Observações

Para mais detalhes sobre startat, veja a secção Observações de Match(String, Int32).

O replacement parâmetro especifica a cadeia que substitui cada jogo e suporta substituições.

Se count for negativo, as substituições continuam até ao fim da corda.

Ver também

• Substituições em expressões regulares
• Linguagem de Expressão Regular - Referência Rápida

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::String ^ replacement);

public static string Replace(string input, string pattern, string replacement);

static member Replace : string * string * string -> string

Public Shared Function Replace (input As String, pattern As String, replacement As String) As String

Parâmetros

Devoluções

Uma nova cadeia que é idêntica à cadeia de entrada, exceto que a cadeia de substituição substitui cada cadeia correspondente. Se pattern não for correspondido na instância atual, o método devolve a instância atual inalterada.

Exceções

Observações

Os métodos estáticos Replace(String, String, String) são equivalentes a construir um Regex objeto com o padrão de expressão regular especificado e chamar o método Replace(String, String)de instância .

O replacement parâmetro especifica a cadeia que substitui cada correspondência em input. replacement pode consistir em qualquer combinação de texto literal e substituições. As substituições são os únicos elementos de linguagem de expressão regular reconhecidos num padrão de substituição.

Como o método retorna input inalterado se não houver correspondência, pode usar o ReferenceEquals(Object, Object) método para determinar se o método fez alguma substituição.

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

Ver também

• Substituições em expressões regulares
• Elementos da Linguagem de Expressões Regulares

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

public:
 static System::String ^ Replace(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::MatchEvaluator ^ evaluator);

public static string Replace(string input, string pattern, System.Text.RegularExpressions.MatchEvaluator evaluator);

static member Replace : string * string * System.Text.RegularExpressions.MatchEvaluator -> string

Public Shared Function Replace (input As String, pattern As String, evaluator As MatchEvaluator) As String

Parâmetros

Devoluções

Uma nova cadeia que é idêntica à cadeia de entrada, exceto que uma corda de substituição substitui cada cadeia correspondente. Se pattern não for correspondido na instância atual, o método devolve a instância atual inalterada.

Exceções

Observações

Este método é útil para substituir uma correspondência de expressões regulares se alguma das seguintes condições for verdadeira: a cadeia de substituição não pode ser facilmente especificada por um padrão de substituição de expressão regular, a cadeia de substituição resulta do processamento da cadeia emparelhada, ou a cadeia de substituição resulta do processamento condicional.

O método é equivalente a chamar o Matches(String, String) método e passar cada Match objeto devolvido MatchCollection ao evaluator delegado.

Como o método retorna input inalterado se não houver correspondência, pode usar o ReferenceEquals(Object, Object) método para determinar se o método fez alguma substituição.

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 avaliar e substituir uma correspondência de padrão é Replace(String, String, MatchEvaluator, RegexOptions, TimeSpan), que permite definir o intervalo de time-out.

Ver também

• MatchEvaluator
• Substituições em expressões regulares
• Elementos da Linguagem de Expressões Regulares

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

public:
 System::String ^ Replace(System::String ^ input, System::String ^ replacement, int count);

public string Replace(string input, string replacement, int count);

member this.Replace : string * string * int -> string

Public Function Replace (input As String, replacement As String, count As Integer) As String

Parâmetros

Devoluções

Uma nova cadeia que é idêntica à cadeia de entrada, exceto que a cadeia de substituição substitui cada cadeia correspondente. Se o padrão de expressão regular não for correspondido na instância atual, o método devolve a instância atual inalterada.

Exceções

Observações

A busca começa no início da input sequência. O replacement parâmetro especifica a cadeia que substitui cada jogo e suporta substituições.

Se count for negativo, as substituições continuam até ao fim da corda.

Como o método retorna input inalterado se não houver correspondência, pode usar o ReferenceEquals(Object, Object) método para determinar se o método fez alguma substituição.

Ver também

• Linguagem de Expressão Regular - Referência Rápida
• Substituições em expressões regulares

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

public:
 System::String ^ Replace(System::String ^ input, System::Text::RegularExpressions::MatchEvaluator ^ evaluator);

public string Replace(string input, System.Text.RegularExpressions.MatchEvaluator evaluator);

member this.Replace : string * System.Text.RegularExpressions.MatchEvaluator -> string

Public Function Replace (input As String, evaluator As MatchEvaluator) As String

Parâmetros

Devoluções

Uma nova cadeia que é idêntica à cadeia de entrada, exceto que uma corda de substituição substitui cada cadeia correspondente. Se o padrão de expressão regular não for correspondido na instância atual, o método devolve a instância atual inalterada.

Exceções

Observações

Este método é útil para substituir uma correspondência de expressões regulares se alguma das seguintes condições for verdadeira: a cadeia de substituição não pode ser facilmente especificada por um padrão de substituição de expressão regular, a cadeia de substituição resulta do processamento da cadeia emparelhada, ou a cadeia de substituição resulta do processamento condicional.

O método é equivalente a chamar o Matches(String) método e passar cada Match objeto devolvido MatchCollection ao evaluator delegado.

Como o método retorna input inalterado se não houver correspondência, pode usar o ReferenceEquals(Object, Object) método para determinar se o método fez alguma substituição.

Ver também

• MatchEvaluator
• Substituições em expressões regulares
• Linguagem de Expressão Regular - Referência Rápida

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

public:
 System::String ^ Replace(System::String ^ input, System::String ^ replacement);

public string Replace(string input, string replacement);

member this.Replace : string * string -> string

Public Function Replace (input As String, replacement As String) As String

Parâmetros

Devoluções

Uma nova cadeia que é idêntica à cadeia de entrada, exceto que a cadeia de substituição substitui cada cadeia correspondente. Se o padrão de expressão regular não for correspondido na instância atual, o método devolve a instância atual inalterada.

Exceções

Observações

A procura pelo padrão começa no início da input corda.

O replacement parâmetro especifica a cadeia que substitui cada correspondência. replacement pode consistir em qualquer combinação de texto literal e substituições. As substituições são os únicos elementos de linguagem de expressão regular reconhecidos num padrão de substituição.

Como o método retorna input inalterado se não houver correspondência, pode usar o ReferenceEquals(Object, Object) método para determinar se o método fez alguma substituição.

Ver também

• Linguagem de Expressão Regular - Referência Rápida
• Substituições em expressões regulares

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

Origem:

Regex.Replace.cs

public:
 System::String ^ Replace(System::String ^ input, System::Text::RegularExpressions::MatchEvaluator ^ evaluator, int count);

public string Replace(string input, System.Text.RegularExpressions.MatchEvaluator evaluator, int count);

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

Public Function Replace (input As String, evaluator As MatchEvaluator, count As Integer) As String

Parâmetros

Devoluções

Uma nova cadeia que é idêntica à cadeia de entrada, exceto que uma corda de substituição substitui cada cadeia correspondente. Se o padrão de expressão regular não for correspondido na instância atual, o método devolve a instância atual inalterada.

Exceções

Observações

Este método é útil para substituir uma correspondência de expressões regulares se alguma das seguintes condições for verdadeira: a cadeia de substituição não pode ser facilmente especificada por um padrão de substituição de expressão regular, a cadeia de substituição resulta do processamento da cadeia emparelhada, ou a cadeia de substituição resulta do processamento condicional.

O método é equivalente a chamar o Matches(String) método e passar os primeiros countMatch objetos devolvidos MatchCollection ao evaluator delegado.

Se count for negativo, as substituições continuam até ao fim da corda.

Como o método retorna input inalterado se não houver correspondência, pode usar o ReferenceEquals(Object, Object) método para determinar se o método fez alguma substituição.

Ver também

• MatchEvaluator
• Substituições em expressões regulares
• Linguagem de Expressão Regular - Referência Rápida