Tipos aninhados devem ser visíveis
TypeName |
NestedTypesShouldNotBeVisible |
CheckId |
CA1034 |
Category (Categoria) |
Microsoft.Design |
Quebrando alterar |
Quebrando |
Causa
Um tipo visível externamente contém uma declaração de tipo visível externamente.Enumeradores aninhados e tipos protegidos são isentos desta regra.
Descrição da regra
Um tipo aninhado é um tipo declarado no escopo de outro tipo.Tipos aninhados são úteis para encapsular os detalhes de implementação privada do tipo recipiente.Usado para essa finalidade, tipos aninhados não devem ser visíveis externamente.
Não não uso visível externamente tipos aninhados para agrupamento lógico ou para evitar conflitos de nome; em vez disso, use espaços para nome.
Tipos aninhados incluem a noção de acessibilidade do membro, que alguns programadores não compreendem claramente.
Tipos protegidos podem ser usados em subclasses e tipos aninhados em cenários de personalização avançada.
Como corrigir violações
Se não for do tipo aninhado seja visível externamente, altere acessibilidade do tipo de.Caso contrário, remova do tipo aninhado seu pai.Se for a finalidade de aninhamento categorizar o tipo aninhado, use um espaço para nome para criar a hierarquia em vez disso.
Quando suprimir avisos
Não suprimir um aviso da regra.
Exemplo
O exemplo a seguir mostra um tipo que viola a regra.
Imports System
Namespace DesignLibrary
Class ParentType
Public Class NestedType
Sub New()
End Sub
End Class
Sub New()
End Sub
End Class
End Namespace
using System;
namespace DesignLibrary
{
internal class ParentType
{
public class NestedType
{
public NestedType()
{
}
}
public ParentType()
{
NestedType nt = new NestedType();
}
}
}
using namespace System;
namespace DesignLibrary
{
public ref class ParentType
{
public:
ref class NestedType
{
public:
NestedType()
{
}
};
ParentType()
{
NestedType^ nt = gcnew NestedType();
}
};
}