嵌套类型不应是可见的

更新：2007 年 11 月

原因

外部可见类型包含外部可见的类型声明。嵌套枚举数和受保护的类型不受此规则限制。

规则说明

嵌套类型是在另一个类型的范围中声明的类型。嵌套类型用于封装包含类型的私有实现详细信息。如果用于此用途，则嵌套类型不应是外部可见的。

不要将外部可见的嵌套类型用于逻辑分组或用于避免名称冲突；请改用命名空间。

嵌套类型包含成员可访问性的概念，不是所有的程序员都清楚了解该概念。

受保护的类型可用于高级自定义方案中的子类和嵌套类型。

如何修复冲突

如果您不希望嵌套类型在外部可见，请更改该类型的可访问性。否则，从嵌套类型的父类型中移除它。如果嵌套的目的是对嵌套类型进行分类，请改为使用命名空间创建层次结构。

何时禁止显示警告

不要禁止显示此规则发出的警告。

示例

下面的示例演示一个与该规则冲突的类型。

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();
        }
    };
}