更新:2007 年 11 月
对于组成类库的元素(包括程序集、命名空间、类型、成员和参数),命名准则提供如何为这些元素选择合适的标识符的准则。选择符合这些准则的标识符可以提高您的库的可用性,并使用户相信您的库将不需要学习一组新的规则。
为了提供一致的开发人员体验,公共公开的元素(如公共类和受保护的方法)必须遵守这些准则。然而,为在整个代码中保持一致性以及改进可维护性,应考虑在整个代码中始终使用这些约定。
部分版权所有 2005 Microsoft Corporation。保留所有权利。
部分版权所有 Addison-Wesley Corporation。保留所有权利。
有关设计指南的更多信息,请参见 Krzysztof Cwalina 和 Brad Abrams 编著、Addison-Wesley 于 2005 年出版的“Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries”(《框架设计指南:可重用 .NET 库的约定、术语和模式》)。
本节内容
大小写约定
描述不同的大小写系统和每个系统的使用场合。通用命名约定
描述选择明确的可读名称的一般规则。程序集和 DLL 的名称
描述命名托管程序集的约定。命名空间的名称
描述用于命名空间名称的约定以及如何最小化命名空间之间的冲突。类、结构和接口的名称
描述命名类型时应遵循或避免的约定。类型成员的名称
描述为方法、属性、字段和事件选择名称的最佳做法。参数名
描述选择有含义的参数名称的最佳做法。资源的名称
描述为可本地化的资源选择名称的最佳做法。