框架设计指南 构建可复用.NET库的约定、惯例与模式(第3版)

"（1）从“要做”和“不要做”两个视角彼此推翻和对抗，推演规范形成的终极思辨逻辑。 （2）针对语言构成剖析编码规范, 提供一种上手一门新语言快速登堂入室的新思路。 （3）被誉为C# 世界的《Effective C++》，各路大神精彩点评是这本书的点睛之笔。 （4）广泛流传这样一句话：. NET程序员如一生只读三本书，这本书必定赫然在列。"

本书从最基本的设计原则和准则出发，全方位介绍了设计框架的很好实践，是微软工程师从.NET Framework开发伊始到现如今的.NET这二十来年间宝贵经验的总结。
与第2版发布时的2008年相比，今天的软件开发范式用翻天覆地来形容也不为过，容器化、云服务、跨平台、DevOps等，都对今天的软件开发者和框架设计者提出了更高的要求。本书对第2版的内容进行了全面的更新，以适应当下发展的潮流。
本书虽然是面向.NET平台上的框架设计的，但对其他平台的框架设计同样具有非凡的借鉴价值。通过阅读本书，读者可以了解到如何设计出一个对使用者而言简单、易用且具有一致性的优秀框架。

"Krzysztof Cwalina 是微软的软件架构师，是 .NET框架团队的初始成员之一，在职业生涯中，他成功设计了许多 .NET API。目前，他正致力于帮助微软的不同团队开发不同编程语言下的可复用 API。Krzysztof 拥有爱荷华大学计算机科学专业的学士学位和硕士学位。 Jeremy Barton 是 .NET Core Libraries 团队的一名工程师。在使用 C# 设计和开发小型框架十几年后，他于 2015 年加入 .NET 团队，从事全新的 .NET Core 项目中密码学相关类库的跨平台开发工作。Jeremy 毕业于罗斯-霍曼理工学院计算机科学和数学专业。 Brad Abrams 是微软通用语言运行时（Common Language Runtime，CLR）和 .NET 框架团队的初始成员之一。从 1998 年开始，他就一直在为 .NET 框架做设计。Brad 从构建基类库（BCL）开始他的框架设计生涯，而这个库后来成为 .NET框架的核心部分。此外，他还是通用语言规范（Common Language Specification，CLS）、.NET框架设计指南和.NET框架中ECMA/ISO通用语言基础架构（Common Language Infrastructure，CLI）标准实现的主要作者。Brad 编写和合著了多本出版物，包括Programming in the .NET Environment和.NET Framework Standard Library Annotated Reference的卷一和卷二。Brad 毕业于北卡罗来纳州立大学计算机科学专业，你可以在他的博客上了解他最近的想法。Brad现在是Google的集团产品经理（Group Product Manager），他正在为 Google Assistant孵化新项目。 译者简介 王桥，2016年毕业于厦门大学，现在是微软的软件开发工程师。他在大学毕业后就一直深耕于 Web开发领域，在 TypeScript/JavaScript 和 . NET 等方面有丰富的编程实战经验。"

导论1
1.1设计精良的框架的特质2
1.1.1设计精良的框架是简单的2
1.1.2设计精良的框架设计成本高昂3
1.1.3设计精良的框架充满权衡4
1.1.4设计精良的框架会借鉴过往经验5
1.1.5设计精良的框架旨在不断发展5
1.1.6设计精良的框架是完整统一的6
1.1.7设计精良的框架是一致的6
2框架设计基础7
2.1渐进式框架9
2.2框架设计基本原则12
2.2.1场景驱动设计原则12
2.2.2低门槛原则18
2.2.3对象模型自文档化原则22
2.2.4分层架构原则27
总结29
3命名准则30
3.1大小写约定30
3.1.1标识符的大小写规则31
3.1.2大写首字母缩写词33
3.1.3大写复合词和常见术语36
3.1.4大小写敏感38
3.2通用命名约定38
3.2.1词汇选择39
3.2.2使用简写和首字母缩写词41
3.2.3避免使用特定于编程语言的名称41
3.2.4命名现有API的新版本43
3.3程序集、DLL和包的命名45
3.4命名空间的命名47
3.4.1命名空间和类型名称的冲突48
3.5类、结构体和接口的命名50
3.5.1泛型参数的命名52
3.5.2通用类型的命名52
3.5.3枚举的命名53
3.6类型成员的命名55
3.6.1方法的命名55
3.6.2属性的命名55
3.6.3事件的命名57
3.6.4字段的命名58
3.7命名参数59
3.7.1命名运算符重载参数59
3.8命名资源60
总结60
4类型设计准则61
4.1类型和命名空间63
4.2在类和结构体之间选择66
4.3在类和接口之间选择68
4.4抽象类设计75
4.5静态类设计76
4.6接口设计77
4.7结构体设计79
4.8枚举设计83
4.8.1设计标记枚举89
4.8.2添加枚举值92
4.9嵌套类型93
4.10类型和程序集元数据95
4.11强类型字符串97
总结100
5成员设计101
5.1一般成员设计准则101
5.1.1成员重载101
5.1.2显式实现接口成员111
5.1.3在属性和方法之间选择114
5.2属性设计119
5.2.1索引属性设计120
5.2.2属性变更通知事件123
5.3构造函数设计124
5.3.1类型构造函数准则130
5.4事件设计132
5.5字段设计136
5.6扩展方法139
5.7运算符重载146
5.7.1重载operator==149
5.7.2转换运算符149
5.7.3比较运算符151
5.8参数设计152
5.8.1在枚举参数和布尔参数之间选择154
5.8.2参数验证156
5.8.3参数传递159


5.8.4参数数量可变的成员162

……