框架设计准则

本部分提供了有关设计扩展 .NET Framework 并与 .NET Framework 进行交互的库的指南。 其目标是通过提供独立于用于开发的编程语言的统一编程模型,来帮助库设计人员确保 API 一致性和易用性。 建议在开发扩展 .NET Framework 的类和组件时遵循这些设计准则。 库设计不一致会对开发人员工作效率产生负面影响,并阻碍采用。

本指南分为几组简单的建议,其前缀分别为 DoConsiderAvoidDo not。 这些准则旨在帮助类库设计人员了解不同解决方案之间的权衡。 在某些情况下,良好的库设计需要你违反这些设计准则。 这种情况应该很少见,因此你需要依据一个清晰且令人信服的理由作出决策。

这些准则摘自《Framework 设计准则:可重用 .NET 库的约定、惯例和模式第 2 版》,作者:Krzysztof Cwalina 和 Brad Abrams。

本节内容

命名规则
提供针对类库中的命名程序集、命名空间、类型和成员的准则。

类型设计准则
提供有关使用静态和抽象类、接口、枚举、结构和其他类型的准则。

成员设计准则
提供有关设计和使用属性、方法、构造函数、字段、事件、运算符和参数的准则。

扩展性设计
讨论扩展性机制(如子类化、使用事件、虚拟成员和回调),并说明如何选择最能满足框架要求的机制。

异常设计准则
介绍有关设计、引发和捕获异常的设计准则。

使用准则
介绍有关使用常见类型(如数组、特性和集合、支持序列化以及重载相等性运算符)的准则。

常用设计模型
提供有关选择和实现依赖项属性的准则。

Portions © 2005, 2009 Microsoft Corporation 版权所有。 保留所有权利。

在 Pearson Education, Inc. 授权下,由 Addison-Wesley Professional 作为 Microsoft Windows 开发系列的一部分再版自 Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, 2nd Edition(Framework 设计准则:可重用 .NET 库的约定、惯例和模式第 2 版),由 Krzysztof Cwalina 和 Brad Abrams 发布于 2008 年 10 月 22 日。

请参阅