Partilhar via


CA1020: evitar namespaces com poucos tipos

TypeName

AvoidNamespacesWithFewTypes

CheckId

CA1020

Categoria

Microsoft.Design

Alteração Significativa

Quebra

Causa

Um namespace diferente do namespace global contiver menos de cinco tipos.

Descrição da Regra

Verifique se cada um de seus namespaces tiver uma organização lógica, e que um motivo válido existe para colocar em um namespace escassa preenchida.Os namespaces devem conter os tipos que são usados em conjunto na maioria dos cenários.Quando os aplicativos são mutuamente exclusivos, os tipos devem ser localizados em namespaces separadas.Por exemplo, o namespace de System.Web.UI contém tipos que são usados em aplicativos Web, e o namespace de System.Windows.Forms contém tipos que são usados em aplicativos baseados no de Windows.Mesmo que as duas namespaces tem tipos que controlam aspectos da interface do usuário, esses tipos não são projetados para uso no mesmo aplicativo.Consequentemente, estão localizados em namespaces separadas.A organização cuidadosa de namespace também pode ser útil porque aumenta a capacidade de descoberta de um recurso.Revisando a hierarquia de namespace da biblioteca, os consumidores devem conseguir localizar os tipos que implementam um recurso.

ObservaçãoObservação

Os tipos de tempo de design e as permissões não devem ser mesclados em outros namespaces de acordo com essa diretriz.Esses tipos pertencem em seus próprios namespaces abaixo de seu namespace principal, e namespaces devem terminar em .Design e em .Permissions, respectivamente.

Como Corrigir Violações

Para corrigir uma violação desta regra, tente combinar os namespaces que contêm apenas alguns tipos em um único namespace.

Quando Suprimir Alertas

É seguro suprimir um aviso desta regra não quando o namespace contém tipos que são usados com os tipos em suas outros namespaces.