.NET设计规范:约定、惯用法与模式(第2版.英文影印版)(.NET开发者的必备图书,附赠DVD光盘)

.3.1.3 capitalizing compound words and common terms 43
3.1.4 case sensitivity 45
3.2 general naming conventions 46
3.2.1 wordchoice 46
3.2.2 using abbreviations and acronyms 48
3.2.3 avoiding language-specific names 49
3.2.4 naming new versions of existing apis 51
3.3 names of assemblies and dlls 54
3.4 names of namespaces 56
3.4.1 namespaces and type name conflicts 58
3.5 names of classes, structs, and interfaces 60
3.5.1 names of generic type parameters 64
3.5.2 names of common types 64
3.5.3 naming enumerations 66
3.6 names of type members 68
3.6.1 names of methods 68
3.6.2 names of properties 68
3.6.3 names of events 70
3.6.4 naming fields 72
3.7 naming parameters 73
3.7.1 naming operator overload parameters 74
3.8 naming resources 74
4 type design guidelines 77
4.1 types and namespaces 79
4.1.1 standard subnamespace names 83
4.2 choosing between class and struct 84
4.3 choosing between class and interface 88
4.4 abstract class design 95
4.5 static class design 97
4.6 interface design 98
4.7 struct design 101
4.8 enumdesign 103
4.8.1 designing flag enums 110
4.8.2 adding values to enums 114
4.9 nested types 115
4.10 types and assembly metadata 118
5 memberdesign 121
5.1 general member design guidelines 121
5.1.1 member overloading 121
5.1.2 implementing interface members explicitly 128
5.1.3 choosing between properties and methods 132
5.2 property design 138
5.2.1 indexed property design 140
5.2.2 property change notification events 142
5.3 constructor design 144
5.3.1 type constructor guidelines 151
5.4 event design 153
5.4.1 custom event handler design 159
5.5 field design 159
5.6 extension methods 162
5.7 operator overloads 168
5.7.1 overloading operator == 173
5.7.2 conversion operators 173
5.8 parameter design 175
5.8.1 choosing between enum and boolean parameters 177
5.8.2 validating arguments 179
5.8.3 parameter passing 183
5.8.4 members with variable number of parameters 186
5.8.5 pointer parameters 190
6 designing for extensibility 193
6.1 extensibility mechanisms 193
6.1.1 unsealed classes 194
6.1.2 protected members 196
6.1.3 events and callbacks 197
6.1.4 virtual members 201
6.1.5 abstractions (abstract types and interfaces) 203
6.2 base classes 206
6.3 sealing 207
7 exceptions 211
7.1 exception throwing 216
7.2 choosing the right type of exception to throw 221
7.2.1 error message design 225
7.2.2 exception handling 227
7.2.3 wrapping exceptions 232
7.3 using standard exception types 234
7.3.1 exceptcon and systemexcept~on 234
7.3.2 appl ~cat~onexcept~on 234
7.3.3 inval ~doperat~onexceptcon 235
7.3.4 argumentexcept~on, argumentnul lexcept~on, and
argumentoutofrangeexcept~on 235
7.3.5 nul lreferenceexcept~on, indexoutofrangeexcept~on, and
accessvcolatconexcept~on 237
7.3.6 stackoverflowexcept~on 237
7.3.70utofmemoryexcept~on 238
7.3.8 comexcept~on, sehexceptcon, and execut~oneng~ne-
exception 239
7.4 designing custom exceptions 239
7.5 exceptions and performance 240
7.5.1 tester-doer pattern 241
7.5.2 try-parse pattern 242
8 usage guidelines 245
8.1 arrays 245
8.2 attributes 247
8.3 collections 250
8.3.1 collection parameters 252
8.3.2 collection properties and return values 253
8.3.3 choosing between arrays and collections 258
8.3.4 implementing custom collections 259
8.4 datetime and datetimeoffset 261
8.5 icloneable 263
8.6 icomparable(t) and iequatable(t) 264
8.7 idisposable 266
8.8 nuiiable(t) 266
8.9 object 268
8.9.1 object. equals 268
8.9.2 object. gethashcode 270
8.9.3 object. tostrlng 271
8.10 serialization 274
8.10.1 choosing the right serialization technology to support 275
8.10.2 supporting data contract serialization 276
8.10.3 supporting xml serialization 280
8.10.4 supporting runtime serialization 281
8.11 url 283
8.11.1 system. urn. implementation guidelines 284
8,12 system.xml usage 284
8.13 equality operators 286
8.13.1 equality operators on value types 287
8.13.2 equality operators on reference types 287
9 common design patterns 289
9.1 aggregate components 289
9.1.1 component-oriented design 291
9.1.2 factoredtypes 294
9.1.3 aggregate component guidelines 295
9.2 the async patterns 298
9.2.1 choosing between the async patterns 298
9.2.2 classic async pattern 300
9.2.3 classic async pattern basic implementation example 304
9.2.4 event-based async pattern 305
9.2.5 supporting out and ref parameters 307
9.2.6 supporting cancellation 308
9.2.7 supporting progress reporting 309
9.2.8 supporting incremental results 311
9.3 dependency properties 312
9.3.1 dependency property design 313
9.3.2 attached dependency property design 315
9.3.3 dependency property validation 316
9.3.4 dependency property change notifications 317
9.3.5 dependency property value coercion 318
9.4 dispose pattern 319
9.4.1 basic dispose pattern 322
9.4.2 finalizable types 328
9.5 factories 332
9.6 linq support 337
9.6.1 overview of linq 337
9.6.2 ways of implementing linq support 339
9.6.3 supporting linq through ienumerable(t) 339
9.6.4 supporting linq through ioueryable~t~ 340
9.6.5 supporting linq through the query pattern 341
9.7 optional feature pattern 344
9.8 simulating covariance 348
9.9 template method 354
9.10 timeouts 356
9.11 xaml readable types 358
9.12 and in the end... 361
a c# coding style conventions 363
a.1 general style conventions 364
a.1.1 brace usage 364
a.1.2 space usage 365
a.1.3 indent usage 367
a.1.4 other 367
a.2 naming conventions 367
a.3 comments 368
a.4 file organization 369
b using fxcop to enforce the framework design guidelines 371
b.1 what is fxcop? 371
b.2 the evolution of fxcop 372
b.3 how does it work? 373
b.4 fxcop guideline coverage 374
b.4.1 fxcop rules for the naming guidelines 374
b.4.2 fxcop rules for the type design guidelines 384
b.4.3 fxcop rules for member design 387
b.4.4 fxcop rules for designing for extensibility 394
b.4,5 fxcop rules for exceptions 395
b.4.6 fxcop rules for usage guidelines 397
b.4.7 fxcop rules for design patterns 402
c sample api specification 405
glossary 413
suggested reading list 419
index 423

.　　public bool Equals(Int32 other){ ...}}
　　语言选择和样例代码
　　公共语言运行库（CLR）的目标之一就是支持多种编程语言，这其中既包括微软提供的语言，如C++、VB、C#、F#、Python和Ruby，也包括第三方语言，如Eiffel、COBOL和Fortran等。因此，本书适用于开发和使用现代框架的多种语言。
　　为了加强多语言框架设计的概念，我们曾考虑过使用几种不同的编程语言来编写样例代码。但最终我们还是放弃了这种想法，因为使用不同的语言虽然有助于理念的表达，但这样做可能会迫使读者学习好几种新语言，而这并不是本书的目的。
　　我们决定使用一种易于为广大开发人员阅读的语言，最终选择了C#，因为C#是一种简单的语言，它源自C语言家族——一个在框架开发方面有着悠久历史的家族（C家族中的其他语言包括C、C++、Java和C#）。
　　语言的选择对于许多程序员来说至关重要，对那些不适应C#的读者，我们谨在此表示歉意。
　　关于本书
　　本书提供了自顶向下的框架设计规范。
　　·第1章简要介绍了本书，讨论了框架设计的理念，这是书中唯一没有规范的一章。
　　·第2章为框架的总体设计提供了基本的原则和规范。
　　·第3章包含了常用设计惯用法以及为命名空间、类型、成员等框架各部分命名的规范。
　　·第4章为类型设计提供了规范。
　　·第5章为类型成员的设计提供了进一步的规范。
　　·第6章讨论了一些对保证框架的扩展性来说至关重要的问题和规范。
　　·第7章为与异常有关的工作提供了规范，及推荐使用的错误报告机制。
　　·第8章为扩展和使用框架中的常用类型提供了规范。
　　·第9章为框架中常用的设计模式提供了规范和示例。
　　·附录A对本书使用的编程约定做了简要的描述。
　　·附录B介绍了FxCop工具。可以用该工具来分析框架的二进制文件，以验证框架是否符合本书所描述的规范。本书的附带光盘中包括了此工具。
　　·附录C是一份API规范样例，这些规范通常是微软公司的框架设计人员在设计API时创建的。
　　本书附带光盘还包括了另一份API规范样例和其他有用的资源。
　　致谢
　　本书实质上是对数千人智慧结晶的一个汇总，对所有这些人我们深表谢意。
　　微软公司的许多人在过去几年中长期努力地工作，是他们提出建议，进行辩论，并最终撰写了书中的许多规范。虽然不可能列出所有的参与者，但在此我们要特别感谢：Chris Anderson、Erik Christensen、Jason Clark、Joe Duffy、Patrick Dussud、Anders Hejlsberg、Jim Miller、Michael Murray、Lance Olson、Eric Gunnerson、Dare Obasanjo、Steve Starck、Kit George、Mike Hillberg、Greg Schecter、Mark Boulter、Asad Jawahar、Justin Van Patten和Mircea Trofin。
　　许多人审阅了本书并提供了评注，我们在此同样表示感谢：Mark Alcazar、Chris Anderson、Christopher Brumme、Pablo Castro、Jason Clark、Steven Clarke、Joe Duffy、Patrick Dussud、Mike Fanning、Kit George、Jan Gray、Brian Grunkemeyer、Eric Gunnerson、Phil Haack、Anders Hejlsberg、David Kean、Rico Mariani、Anthony Moore、Vance Morrison、Christophe Nasarre、Dare Obasanjo、Brian Pepin、Jon Pincus、Jeff Prosise、Brent Rector、Jeffrey Richter、Greg Schechter、Chris Sells、Steve Starck、Herb Sutter、Clemens Szyperski、Mircea Trofin和Paul Vick。
　　上述同仁对本书做了非常必要的补充增益。他们为正文添加了注解内容，补充了有关历史背景知识，让文风变得风趣生动，这些都十分出彩，令本书增色不少。
　　附录B对FxCop的介绍实际上是Sheridan Harrison和David Kean编写的，在此我们对他们表示感谢。
　　感谢Martin Heller，他从技术上、精神上给我们以帮助和支持。感谢Pierre Nallet、George Byrkit、Khristof Falk、Paul Besley、Bill Wagner和Peter Winkler，他们提出了中肯而有益的意见。
　　特别感谢Susann Ragsdale，是她把诸多不甚连续的想法化为本书。她耐心、极具幽默感，她的创作思路完美无瑕，所有这些使得本书的写作过程变得格外轻松。