.NET 设计规范--.NET约定、惯用法与模式

.3.1.2 首字母缩写词的大小写 31
3.1.3 复合词和常用术语的大小写 33
3.1.4 是否区分大小写 35
3.2 通用命名约定 35
3.2.1 单词的选择 36
3.2.2 使用单词缩写和首字母缩写词 37
3.2.3 避免使用语言特有的名字 38
3.2.4 为已有api的新版本命名 39
3.3 程序集和dll的命名 42
3.4 名字空间的命名 43
3.5 类、结构和接口的命名 47
3.5.1 泛型类型参数的命名 49
3.5.2 常用类型的命名 50
3.5.3 枚举类型的命名 51
3.6 类型成员的命名 53
3.6.1 方法的命名 53
3.6.2 属性的命名 54
3.6.3 事件的命名 55
3.6.4 字段的命名 57
3.7 参数的命名 57
3.8 资源的命名 58
3.9 小结 59
第4章 类型设计规范 60
4.1 类型和名字空间 62
4.2 类和结构之间的选择 67
4.3 类和接口之间的选择 69
4.4 抽象类的设计 76
4.5 静态类的设计 78
4.6 接口的设计 79
4.7 结构的设计 81
4.8 枚举的设计 83
4.8.1 标记枚举的设计 89
4.8.2 给枚举添加值 93
4.9 嵌套类型 94
4.10 小结 96
第5章 成员设计 97
5.1 成员设计的一般规范 97
5.1.1 成员重载 97
5.1.2 显式地实现接口成员 102
5.1.3 属性和方法之间的选择 106
5.2 属性的设计 112
5.2.1 索引属性的设计 113
5.2.2 属性改变的通知事件 115
5.3 构造函数的设计 117
5.4 事件的设计 123
5.5 字段的设计 130
5.6 操作符重载 132
5.6.1 重载operator== 136
5.6.2 类型转换操作符 136
5.7 参数的设计 138
5.7.1 枚举和布尔参数之间的选择 140
5.7.2 参数的验证 142
5.7.3 参数的传递 145
5.7.4 参数数量可变的成员 147
5.7.5 指针参数 150
5.8 小结 152
第6章 为扩展性而设计 153
6.1 扩展机制 153
6.1.1 非密封类 153
6.1.2 保护成员 155
6.1.3 事件与回调函数 156
6.1.4 虚成员 158
6.1.5 抽象（抽象类型与抽象接口） 160
6.2 基类 162
6.3 密封 163
6.4 小结 166
第7章 异常 167
7.1 抛出异常 171
7.2 为抛出的异常选择合适的类型 175
7.2.1 错误消息的设计 176
7.2.2 异常处理 177
7.2.3 对异常进行封装 182
7.3 标准异常类型的使用 184
7.3.1 exception与systemexception 184
7.3.2 applicationexception 184
7.3.3 invalidoperationexception 184
7.3.4 argumentexception、argumentnullexception 及argumentoutofrangeexception 185
7.3.5 nullreferenceexception、indexoutofrangeexception及accessviolationexception 186
7.3.6 stackoverflowexception 186
7.3.7 outofmemoryexception 187
7.3.8 comexception、sehexception及其他clr异常 188
7.3.9 executionengineexception 188
7.4 自定义异常的设计 188
7.5 异常与性能 190
7.5.1 tester-doer模式 190
7.5.2 try-parse模式 191
7.6 小结 192
第8章 使用规范 193
8.1 数组 193
8.2 attribute 195
8.3 集合 198
8.3.1 集合参数 199
8.3.2 集合属性与返回值 200
8.3.3 数组与集合之间的选择 204
8.3.4 自定义集合的实现 205
8.4 icloneable 207
8.5 icomparable[t]与iequatable[t] 208
8.6 idisposable 210
8.7 对象 210
8.7.1 object.equals 210
8.7.2 object.gethashcode 212
8.7.3 object.tostring 213
8.8 uri 214
8.9 system.xml的使用 216
8.10 相等性操作符 218
8.10.1 值类型的相等性操作符 218
8.10.2 引用类型的相等性操作符 219
第9章 常用的设计模式 220
9.1 聚合组件 220
9.1.1 面向组件的设计 222
9.1.2 因子类型 224
9.1.3 聚合组件规范 224
9.2 async模式 227
9.3 dispose模式 232
9.3.1 基本dispose模式 234
9.3.2 可终结类型 240
9.4 factory模式 243
9.5 optional feature模式 247
9.6 template method模式 251
9.7 超时 252
9.8 结束语 254
附录a c#编程风格约定 255
a.1 通用风格约定 255
a.1.1 花括号的使用 255
a.1.2 空格的使用 257
a.1.3 缩进的使用 259
a.2 命名约定 259
a.3 注释 260
a.4 文件的组织 261
附录b 通过fxcop来实施设计规范 263
b.1 fxcop是什么？ 263
b.2 fxcop的发展过程 264
b.3 fxcop的工作原理 265
b.4 fxcop规范的覆盖范围 265
b.4.1 与命名规范有关的fxcop规则 265
b.4.2 与类型设计规范有关的fxcop规则 274
b.4.3 与成员的设计有关的fxcop规则 277
b.4.4 与为扩展性而设计有关的fxcop规则 284
b.4.5 与异常有关的fxcop规则 285
b.4.6 与使用规范有关的fxcop规则 287
b.4.7 与设计模式有关的fxcop规则 291
附录c api规范样例 292
术语表 299
推荐读物 303
索引 305

.　　? 避免使用ICollection[T]或ICollection作为参数，如果其目的仅仅只是为了访问Count属性。
　　对那些更为复杂的规范，我们会另外提供一些背景知识、代码示例及基本原理：
　　? 要为值类型实现IEquatable[T]。
　　值类型的Object.Equals方法会导致装箱，而且由于使用了反射，因此默认实现的效率不高。IEquatable[T].Equals能够提供更好的性能，而且它的实现可以避免装箱操作。
　　
　　public struct Int32 : IEquatable[Int32] {
　　 public bool Equals(Int32 other){ … }
　　}
　　语言选择和样例代码
　　公共语言运行库的目标之一就是支持多种编程语言，这其中既包括微软提供的语言，如C++、VB和C#，也包括第三方语言，如Eiffel、COBOL和Python，等等。因此，本书适用于开发和使用现代框架的多种语言。
　　为了加强多语言框架设计的概念，我们曾考虑过使用几种不同的编程语言来编写样例代码。但最终我们还是放弃了这种想法，这是因为使用不同的语言虽然有助于理念的表达，但这样做可能会迫使读者学习好几种新语言，而这并不是本书的目的。
　　我们决定使用一种易于为广大开发人员阅读的语言，最终选择了C#，因为C#是一种简单的语言，它源自C语言家族——一个在框架开发方面有着悠久历史的家族（C家族中的其他语言包括C、C++及Java）。
　　语言的选择对于许多程序员来说至关重要，对那些不适应C#的读者，我们谨在此表示歉意。
　　关于本书
　　本书提供了自顶向下的框架设计规范。
　　·第1章简要介绍了本书，讨论了框架设计的理念，这是书中唯一没有规范的一章。
　　·第2章为框架的总体设计提供了基本的原则和规范。
　　·第3章包含了为框架各部分命名的规范，包括名字空间、类型、成员及常用的设计惯用法。
　　·第4章为类型设计提供了规范。
　　·第5章为类型成员的设计提供了进一步的规范。
　　·第6章讨论了一些对保证框架的扩展性来说至关重要的问题和规范。
　　·第7章为与异常有关的工作提供了规范，及推荐使用的错误报告机制。
　　·第8章为扩展和使用框架中的常用类型提供了规范。
　　·第9章为框架中常用的设计模式提供了规范和示例。
　　·附录A对本书使用的编程约定做了简要的描述。
　　·附录B介绍了FxCop工具。可以用该工具来分析框架的二进制文件，以验证框架是否符合本书所描述的规范。本书的配套资源中包括了此工具。
　　·附录C是一份API规范样例，这些规范通常是微软公司的框架设计人员在设计API时创建的。
　　本书的配套资源 还包括了另一份API规范样例和其他有用的资源。