设计警告

更新：2007 年 11 月

设计警告支持遵守 .NET Framework 设计指导原则。

本节内容

• 抽象类型不应具有构造函数

• 程序集应具有有效的强名称

• 避免使用空接口

• 避免泛型类型的参数过多

• 避免使用类型极少的命名空间

• 避免使用 out 参数

• 集合应实现泛型接口

• 考虑将基类型作为参数传递

• 正确声明事件处理程序

• 在命名空间中声明类型

• 不应使用默认参数

• 定义属性参数的访问器

• 不要捕捉一般异常类型

• 不要在密封类型中声明受保护的成员

• 不要在泛型类型中声明静态成员

• 不要在密封类型中声明虚拟成员

• 不要声明可见实例字段

• 不要公开泛型列表

• 不要隐藏基类方法

• 不要将泛型类型嵌套在成员签名中

• 不要对引用类型重载等号运算符

• 不要在意外的位置引发异常

• 不要通过引用来传递类型

• 枚举存储应为 Int32

• 枚举数应强类型化

• 枚举应具有零值

• 异常应该是公共的

• 泛型方法应提供类型参数

• ICollection 实现含有强类型成员

• 正确实现 IDisposable

• 实现标准异常构造函数

• 索引器不应是多维的

• 接口方法应可由子类型调用

• 列表为强类型

• 用 AssemblyVersionAttribute 标记程序集

• 用 CLSCompliantAttribute 标记程序集

• 用 ComVisibleAttribute 标记程序集

• 用 AttributeUsageAttribute 标记属性

• 用 FlagsAttribute 标记枚举

• 成员不应公开某些具体类型

• 将 P/Invokes 移动到 NativeMethods 类

• 嵌套类型不应是可见的

• 重写可比较类型中的方法

• 重载加运算符和减运算符时应重载相等运算符

• 属性不应是只写的

• 提供 ObsoleteAttribute 消息

• 用参数数组替换重复的变量

• 应密封静态容器类型

• 静态容器类型不应具有构造函数

• 字符串 URI 重载调用 System.Uri 重载

• 类型不应扩展某些基类型

• 具有可释放字段的类型应该是可释放的

• 拥有本机资源的类型应是可释放的

• URI 参数不应为字符串

• URI 属性不应是字符串

• URI 返回值不应是字符串

• 在适用处使用事件

• 使用泛型事件处理程序实例

• 在适用处使用泛型

• 将整型或字符串参数用于索引器

• 在适用处使用属性

• 验证公共方法的参数