Compartilhar via


CA1874: Usar 'Regex.IsMatch'

Propriedade Value
ID da regra CA1874
Title Utilize Regex.IsMatch
Categoria Desempenho
Correção é disruptiva ou não disruptiva Non-breaking
Habilitado por padrão no .NET 10 Como sugestão

Motivo

A Success propriedade do resultado é Regex.Match usada para verificar se um padrão corresponde.

Descrição da regra

Regex.IsMatch é mais simples e mais rápido que Regex.Match(...).Success. O IsMatch método é otimizado para o caso em que você só precisa saber se existe uma correspondência, em vez de qual é a correspondência. Chamar Match() e verificar Success faz um trabalho desnecessário que pode afetar o desempenho.

Como corrigir violações

Substitua chamadas por Regex.Match(...).SuccessRegex.IsMatch(...).

Uma correção de código que executa automaticamente essa transformação está disponível.

Example

O snippet de código a seguir mostra uma violação da CA1874:

using System.Text.RegularExpressions;

class Example
{
    public bool IsValidEmail(string email)
    {
        // Violation
        return Regex.Match(email, @"^[^@\s]+@[^@\s]+\.[^@\s]+$").Success;
    }
}
Imports System.Text.RegularExpressions

Class Example
    Public Function IsValidEmail(email As String) As Boolean
        ' Violation
        Return Regex.Match(email, "^[^@\s]+@[^@\s]+\.[^@\s]+$").Success
    End Function
End Class

O snippet de código a seguir corrige a violação:

using System.Text.RegularExpressions;

class Example
{
    public bool IsValidEmail(string email)
    {
        // Fixed
        return Regex.IsMatch(email, @"^[^@\s]+@[^@\s]+\.[^@\s]+$");
    }
}
Imports System.Text.RegularExpressions

Class Example
    Public Function IsValidEmail(email As String) As Boolean
        ' Fixed
        Return Regex.IsMatch(email, "^[^@\s]+@[^@\s]+\.[^@\s]+$")
    End Function
End Class

Quando suprimir avisos

É seguro suprimir um aviso dessa regra se o desempenho não for uma preocupação.

Suprimir um aviso

Se você quiser suprimir apenas uma única violação, adicione diretivas de pré-processamento ao arquivo de origem para desabilitar e, em seguida, habilitar novamente a regra.

#pragma warning disable CA1874
// The code that's violating the rule is on this line.
#pragma warning restore CA1874

Para desabilitar a regra para um arquivo, pasta ou projeto, defina sua severidade none no arquivo de configuração.

[*.{cs,vb}]
dotnet_diagnostic.CA1874.severity = none

Para obter mais informações, consulte Como suprimir avisos de análise de código.

Consulte também