Partilhar via

CA1874: Use 'Regex.IsMatch'

Propriedade Valor
ID da regra CA1874
Título Utilize Regex.IsMatch
Categoria Desempenho
A correção é invasiva ou não invasiva Non-breaking
Habilitado por padrão no .NET 10 Como sugestão

Motivo

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

Descrição da regra

Regex.IsMatch é mais simples e mais rápido do 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 depois verificar Success faz um trabalho desnecessário que pode afetar o desempenho.

Como corrigir violações

Substitua chamadas para Regex.Match(...).Success por Regex.IsMatch(...).

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

Example

O trecho de código a seguir mostra uma violação de 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 trecho 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 apenas suprimir uma única violação, adicione diretivas de pré-processador ao seu arquivo de origem para desativar e, em seguida, reativar 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 de um arquivo, pasta ou projeto, defina sua gravidade como 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

  • Last updated on