Compartilhar via


Evitar espaços para nomes com alguns tipos

TypeName

AvoidNamespacesWithFewTypes

CheckId

CA1020

Category (Categoria)

Microsoft.Design

Quebrando alterar

Quebrando

Causa

Um espaço para nome diferente de namespace global contém menos de cinco tipos.

Descrição da regra

Certifique-se de que há uma organização lógica para cada um dos seus s namespace e que há um motivo válido para colocação de tipos em escassamente preenchida namespace.Namespaces devem conter tipos que são usados juntos na maioria dos cenários.Quando os aplicativos são mutuamente exclusivo, tipos devem estar localizados em espaços para nome separados.Por exemplo, a System.Web.UI namespace contém tipos que são usados em aplicativos da Web, e o System.Windows.Forms namespace contém tipos que são usados em aplicativos baseados no baseado no Windows. Mesmo que tenham ambos os espaços para nome tipos controle aspectos da interface do usuário, esses tipos não são projetados para ser usado no mesmo aplicativo e, portanto, estão localizados em espaços para nome separados.Cuidado namespace organização também pode ser útil porque aumenta a detectabilidade de um recurso.Examinando a hierarquia de namespace, consumidores de biblioteca devem conseguir localizar os tipos que implementam um recurso.

Observação:

Tipos de time de design e as permissões não devem ser mescladas no outros espaços para nome em conformidade com essa diretriz.Esses tipos pertencem a seus próprios s namespace abaixo seu principal namespace, e s namespace deve terminar em .Design e .Permissions, respectivamente.

Como corrigir violações

Para corrigir uma violação dessa regra, tente agrupar namespace s que contêm um número pequeno de tipos em um único namespace.

Quando suprimir avisos

É seguro eliminar um aviso da regra quando o espaço para nome não contém tipos que são usados com os tipos de seus outros espaços para nomes.