CA1724: Os nomes de tipo não devem corresponder aos namespaces

Propriedade	valor
ID da regra	CA1724
Cargo	Os nomes de tipo não devem corresponder aos namespaces
Categoria	Atribuição de nomes
A correção está quebrando ou não quebrando	Quebrando
Habilitado por padrão no .NET 8	Não

Causa

Um nome de tipo corresponde a um nome de namespace referenciado que tem um ou mais tipos visíveis externamente. 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. Violar esta regra pode reduzir a usabilidade da sua biblioteca.

Como corrigir violações

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

Quando suprimir avisos

Para novos desenvolvimentos, 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 sua biblioteca podem ficar confusos com o nome correspondente. Para bibliotecas de envio, talvez seja necessário suprimir um aviso dessa regra.

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 CA1724
// The code that's violating the rule is on this line.
#pragma warning restore CA1724

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

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

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

Exemplo

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