CA1724: os nomes de tipo não devem corresponder a namespaces

Property	Valor
ID da regra	CA1724
Título	Nomes de tipos não devem corresponder a namespaces
Categoria	Nomenclatura
Correção interruptiva ou sem interrupção	Quebra
Habilitado por padrão no .NET 9	Não

Causa

Um nome de tipo corresponde a um nome de namespace referenciado que tem um ou mais tipos externamente visíveis. A comparação de nomes não diferencia maiúsculas de minúsculas.

Descrição da regra

Os nomes de tipo criados pelo usuário não devem corresponder aos nomes de namespaces referenciados que têm tipos visíveis externamente. A violação dessa regra pode reduzir a usabilidade da biblioteca.

Como corrigir violações

Altere o nome do tipo de modo que ele não corresponda ao nome de um namespace referenciado que tenha tipos visíveis externamente.

Quando suprimir avisos

Para o novo desenvolvimento, não ocorrem cenários conhecidos em que você deve suprimir um aviso dessa regra. Antes de suprimir o aviso, considere cuidadosamente como os usuários da biblioteca podem ficar confusos com o nome correspondente. Para bibliotecas de envio, talvez seja necessário suprimir um aviso dessa regra.

Suprimir um aviso

Para suprimir apenas uma violação, adicione diretivas de pré-processador ao arquivo de origem a fim de desabilitar e, em seguida, reabilitar a regra.

C#

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

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

ini

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

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

Exemplo

C#

namespace MyNamespace
{
    // This class violates the rule
    public class System
    {
    }
}