框架設(shè)計(jì)指南：構(gòu)建可復(fù)用.NET庫(kù)的約定、慣例與模式（第3版）

導(dǎo)論 1
1.1 設(shè)計(jì)精良的框架的特質(zhì) 2
1.1.1 設(shè)計(jì)精良的框架是簡(jiǎn)單的 2
1.1.2 設(shè)計(jì)精良的框架設(shè)計(jì)成本高昂 3
1.1.3 設(shè)計(jì)精良的框架充滿權(quán)衡 4
1.1.4 設(shè)計(jì)精良的框架會(huì)借鑒過(guò)往經(jīng)驗(yàn) 5
1.1.5 設(shè)計(jì)精良的框架旨在不斷發(fā)展 5
1.1.6 設(shè)計(jì)精良的框架是完整統(tǒng)一的 6
1.1.7 設(shè)計(jì)精良的框架是一致的 6
2 框架設(shè)計(jì)基礎(chǔ) 7
2.1 漸進(jìn)式框架 9
2.2 框架設(shè)計(jì)基本原則 12
2.2.1 場(chǎng)景驅(qū)動(dòng)設(shè)計(jì)原則 12
2.2.2 低門(mén)檻原則 18
2.2.3 對(duì)象模型自文檔化原則 22
2.2.4 分層架構(gòu)原則 27
總結(jié) 29
3 命名準(zhǔn)則 30
3.1 大小寫(xiě)約定 30
3.1.1 標(biāo)識(shí)符的大小寫(xiě)規(guī)則 31
3.1.2 大寫(xiě)首字母縮寫(xiě)詞 33
3.1.3 大寫(xiě)復(fù)合詞和常見(jiàn)術(shù)語(yǔ) 36
3.1.4 大小寫(xiě)敏感 38
3.2 通用命名約定 38
3.2.1 詞匯選擇 39
3.2.2 使用簡(jiǎn)寫(xiě)和首字母縮寫(xiě)詞 41
3.2.3 避免使用特定于編程語(yǔ)言的名稱(chēng) 41
3.2.4 命名現(xiàn)有 API 的新版本 43
3.3 程序集、DLL 和包的命名 45
3.4 命名空間的命名 47
3.4.1 命名空間和類(lèi)型名稱(chēng)的沖突 48
3.5 類(lèi)、結(jié)構(gòu)體和接口的命名 50
3.5.1 泛型參數(shù)的命名 52
3.5.2 通用類(lèi)型的命名 52
3.5.3 枚舉的命名 53
3.6 類(lèi)型成員的命名 55
3.6.1 方法的命名 55
3.6.2 屬性的命名 55
3.6.3 事件的命名 57
3.6.4 字段的命名 58
3.7 命名參數(shù) 59
3.7.1 命名運(yùn)算符重載參數(shù) 59
3.8 命名資源 60
總結(jié) 60
4 類(lèi)型設(shè)計(jì)準(zhǔn)則 61
4.1 類(lèi)型和命名空間 63
4.2 在類(lèi)和結(jié)構(gòu)體之間選擇 66
4.3 在類(lèi)和接口之間選擇 68
4.4 抽象類(lèi)設(shè)計(jì) 75
4.5 靜態(tài)類(lèi)設(shè)計(jì) 76
4.6 接口設(shè)計(jì) 77
4.7 結(jié)構(gòu)體設(shè)計(jì) 79
4.8 枚舉設(shè)計(jì) 83
4.8.1 設(shè)計(jì)標(biāo)記枚舉 89
4.8.2 添加枚舉值 92
4.9 嵌套類(lèi)型 93
4.10 類(lèi)型和程序集元數(shù)據(jù) 95
4.11 強(qiáng)類(lèi)型字符串 97
總結(jié) 100
5 成員設(shè)計(jì) 101
5.1 一般成員設(shè)計(jì)準(zhǔn)則 101
5.1.1 成員重載 101
5.1.2 顯式實(shí)現(xiàn)接口成員 111
5.1.3 在屬性和方法之間選擇 114
5.2 屬性設(shè)計(jì) 119
5.2.1 索引屬性設(shè)計(jì) 120
5.2.2 屬性變更通知事件 123
5.3 構(gòu)造函數(shù)設(shè)計(jì) 124
5.3.1 類(lèi)型構(gòu)造函數(shù)準(zhǔn)則 130
5.4 事件設(shè)計(jì) 132
5.5 字段設(shè)計(jì) 136
5.6 擴(kuò)展方法 139
5.7 運(yùn)算符重載 146
5.7.1 重載 operator== 149
5.7.2 轉(zhuǎn)換運(yùn)算符 149
5.7.3 比較運(yùn)算符 151
5.8 參數(shù)設(shè)計(jì) 152
5.8.1 在枚舉參數(shù)和布爾參數(shù)之間選擇 154
5.8.2 參數(shù)驗(yàn)證 156
5.8.3 參數(shù)傳遞 159
5.8.4 參數(shù)數(shù)量可變的成員 162
5.8.5 指針參數(shù) 165
5.9 在成員簽名中使用元組 166
總結(jié) 171
6 可擴(kuò)展性設(shè)計(jì) 172
6.1 可擴(kuò)展性機(jī)制 172
6.1.1 非密封類(lèi) 172
6.1.2 受保護(hù)的成員 174
6.1.3 事件和回調(diào) 175
6.1.4 虛成員 180
6.1.5 抽象（抽象類(lèi)和接口） 181
6.2 基類(lèi) 183
6.3 密封 185
總結(jié) 187
7 異常 188
7.1 拋出異常 192
7.2 選擇拋出正確的異常類(lèi)型 196
7.2.1 錯(cuò)誤消息設(shè)計(jì) 199
7.2.2 異常處理 200
7.2.3 包裝異常 205
7.3 使用標(biāo)準(zhǔn)異常類(lèi)型 206
7.3.1 Exception和SystemException 206
7.3.2 ApplicationException 207
7.3.3 InvalidOperationException 207
7.3.4 ArgumentException、ArgumentNullException 和 ArgumentOutOfRangeException 207
7.3.5 NullReferenceException、IndexOutOfRangeException 和 AccessViolationException 208
7.3.6 StackOverflowException 208
7.3.7 OutOfMemoryException 209
7.3.8 ComException、SEHException和ExecutionEngineException 210
7.3.9 OperationCanceledException 和 TaskCanceledException 210
7.3.10 FormatException 210
7.3.11 PlatformNotSupportedException 211
7.4 設(shè)計(jì)自定義異常 211
7.5 異常和性能 212
7.5.1 測(cè)試者-執(zhí)行者模式 212
7.5.2 Try模式 213
總結(jié) 216
8 使用準(zhǔn)則 217
8.1 數(shù)組 217
8.2 特性 220
8.3 集合 223
8.3.1 集合參數(shù) 224
8.3.2 集合屬性和返回值 225
8.3.3 在數(shù)組和集合之間選擇 229
8.3.4 實(shí)現(xiàn)自定義集合 230
8.4 DateTime 和 DateTimeOffset 231
8.5 ICloneable 233
8.6 IComparable＜T＞ 和 IEquatable＜T＞ 234
8.7 IDisposable 236
8.8 Nullable＜T＞ 236
8.9 Object 237
8.9.1 Object.Equals 237
8.9.2 Object.GetHashCode 238
8.9.3 Object.ToString 240
8.10 序列化 241
8.11 Uri 243
8.11.1 System.Uri 的實(shí)現(xiàn)準(zhǔn)則 244
8.12 System.Xml 的使用 245
8.13 相等運(yùn)算符 246
8.13.1 值類(lèi)型上的相等運(yùn)算符 248
8.13.2 引用類(lèi)型上的相等運(yùn)算符 248
9 通用設(shè)計(jì)模式 249
9.1 聚合組件 249
9.1.1 面向組件的設(shè)計(jì) 251
9.1.2 因子類(lèi)型 253
9.1.3 聚合組件準(zhǔn)則 254
9.2 異步模式 256
9.2.1 選擇異步模式 256
9.2.2 基于任務(wù)的異步模式 258
9.2.3 異步方法的返回類(lèi)型 263
9.2.4 為現(xiàn)有的同步方法制作一個(gè)異步變體 265
9.2.5 異步模式一致性的實(shí)現(xiàn)準(zhǔn)則 268
9.2.6 經(jīng)典異步模式 272
9.2.7 基于事件的異步模式 273
9.2.8 IAsyncDisposable 273
9.2.9 IAsyncEnumerable＜T＞ 273
9.2.10 await foreach 的使用準(zhǔn)則 274
9.3 依賴(lài)屬性 276
9.3.1 依賴(lài)屬性設(shè)計(jì) 277
9.3.2 附加屬性的設(shè)計(jì) 279
9.3.3 依賴(lài)屬性校驗(yàn) 280
9.3.4 依賴(lài)屬性變更通知 280
9.3.5 依賴(lài)屬性中的值強(qiáng)制 281
9.4 Dispose 模式 282
9.4.1 基本Dispose模式 284
9.4.2 可終結(jié)類(lèi)型 290
9.4.3 限定作用域的操作 293
9.4.4 IAsyncDisposable 296
9.5 工廠 299
9.6 LINQ 支持 303
9.6.1 LINQ 概覽 303
9.6.2 實(shí)現(xiàn) LINQ 支持的方法 304
9.7 可選功能模式 309
9.8 協(xié)變和逆變 312
9.8.1 逆變 315
9.8.2 協(xié)變 316
9.8.3 模擬協(xié)變模式 319
9.9 模板方法 321
9.10 超時(shí) 323
9.11 XAML 可讀類(lèi)型 324
9.12 操作緩沖 326
9.12.1 數(shù)據(jù)轉(zhuǎn)換操作 338
9.12.2 向緩沖區(qū)中寫(xiě)入固定大小或預(yù)定大小的數(shù)據(jù) 343
9.12.3 使用 Try-Write 模式向緩沖區(qū)中寫(xiě)入數(shù)據(jù) 344
9.12.4 部分寫(xiě)入緩沖區(qū)和OperationStatus 348
9.13 最后 353
附錄A C#編碼風(fēng)格約定 354
A.1 通用風(fēng)格約定 355
A.1.1 花括號(hào)的使用 355
A.1.2 空格的使用 357
A.1.3 縮進(jìn)的使用 358
A.1.4 垂直空白 360
A.1.5 成員修飾符 361
A.1.6 其他 362
A.2 命名約定 367
A.3 注釋 368
A.4 文件組織 369
附錄B 過(guò)時(shí)的準(zhǔn)則 371
B.3 命名準(zhǔn)則中的過(guò)時(shí)準(zhǔn)則 371
B.3.8 命名資源 371
B.4 類(lèi)型設(shè)計(jì)準(zhǔn)則中的過(guò)時(shí)準(zhǔn)則 372
B.4.1 類(lèi)型和命名空間 372
B.5 成員設(shè)計(jì)準(zhǔn)則中的過(guò)時(shí)準(zhǔn)則 374
B.5.4 事件的設(shè)計(jì) 374
B.7 異常設(shè)計(jì)準(zhǔn)則中的過(guò)時(shí)準(zhǔn)則 375
B.7.4 設(shè)計(jì)自定義異常 375
B.8 常見(jiàn)類(lèi)型使用準(zhǔn)則中的過(guò)時(shí)準(zhǔn)則 376
B.8.10 序列化 376
B.9 通用設(shè)計(jì)模式中的過(guò)時(shí)準(zhǔn)則 383
B.9.2 異步模式 383
B.9.4 Dispose 模式 394
附錄C API規(guī)范示例 398
附錄D 不兼容變更 403
D.1 修改程序集 404
D.1.1 改變程序集的名稱(chēng)（） 404
D.2 添加命名空間 405
D.2.1 添加與現(xiàn)有類(lèi)型沖突的命名空間（） 405
D.3 修改命名空間 405
D.3.1 修改命名空間的名稱(chēng)或改變大小寫(xiě)（） 405
D.4 移動(dòng)類(lèi)型 405
D.4.1 通過(guò) [TypeForwardedTo] 移動(dòng)類(lèi)型（） 405
D.4.2 不通過(guò) [TypeForwardedTo] 移動(dòng)類(lèi)型（） 406
D.5 刪除類(lèi)型 406
D.5.1 刪除類(lèi)型（） 406
D.6 修改類(lèi)型 407
D.6.1 密封一個(gè)非密封的類(lèi)型（） 407
D.6.2 解封一個(gè)密封類(lèi)型（） 407
D.6.3 改變類(lèi)型名稱(chēng)的大小寫(xiě)（） 407
D.6.4 改變類(lèi)型名稱(chēng)（） 407
D.6.5 改變類(lèi)型的命名空間（） 408
D.6.6 為結(jié)構(gòu)體添加 readonly 修飾符（） 408
D.6.7 從結(jié)構(gòu)體中移除 readonly 修飾符（） 408
D.6.8 為現(xiàn)有接口添加基接口（） 408
D.6.9 為同一個(gè)泛型接口添加第二個(gè)聲明（） 409
D.6.10 將類(lèi)變更為結(jié)構(gòu)體（） 409
D.6.11 將結(jié)構(gòu)體變更為類(lèi)（） 410
D.6.12 將 struct 變更為 ref struct（） 410
D.6.13 將 ref struct 變更為（非ref）struct（） 410
D.7 添加成員 411
D.7.1 通過(guò) new 修飾符掩蓋基類(lèi)成員（） 411
D.7.2 添加抽象成員（） 411
D.7.3 為非密封類(lèi)型添加成員（） 411
D.7.4 為非密封類(lèi)型添加覆寫(xiě)成員（） 412
D.7.5 為結(jié)構(gòu)體添加第一個(gè)引用類(lèi)型字段（） 412
D.7.6 為接口添加成員（） 412
D.8 移動(dòng)成員 413
D.8.1 將成員移動(dòng)到基類(lèi)中（） 413
D.8.2 將成員移動(dòng)到基接口中（） 413
D.8.3 將成員移動(dòng)到派生類(lèi)型中（） 413
D.9 刪除成員 413
D.9.1 從非密封類(lèi)型中刪除終結(jié)器（） 413
D.9.2 從密封類(lèi)型中刪除終結(jié)器（） 414
D.9.3 刪除非覆寫(xiě)成員（） 414
D.9.4 刪除虛擬成員的override（） 414
D.9.5 刪除抽象成員的override（） 414
D.9.6 刪除或重命名可序列化類(lèi)型的私有字段（?） 415
D.10 重載成員 415
D.10.1 為成員添加第一個(gè)重載（） 415
D.10.2 為引用類(lèi)型參數(shù)添加可選參數(shù)重載（?） 416