深入淺出：ASP.NET Core

第1章  初始化ASP.NET Core應(yīng)用程序 1
1.1  應(yīng)用程序的啟動(dòng)過(guò)程 1
1.2  WebApplicationBuilder類(lèi) 2
1.3  啟動(dòng)應(yīng)用程序 3
1.4  使用Host初始化應(yīng)用程序 4
1.4.1  通用主機(jī) 5
1.4.2  示例：簡(jiǎn)單的通用主機(jī) 5
1.4.3  Web主機(jī) 7
1.5  設(shè)置應(yīng)用程序的URL 9
1.5.1  調(diào)用UseUrls()方法 9
1.5.2  使用WebApplication類(lèi)的Urls屬性 10
1.5.3  調(diào)用Run()方法時(shí)傳遞URL 10
1.5.4  通過(guò)ServerAddressesFeature對(duì)象設(shè)置URL 11
1.5.5  使用命令行參數(shù) 12
1.5.6  使用配置文件 13
1.5.7  使用環(huán)境變量 13
1.5.8  使用launchSettings.json文件 14
1.5.9  Kestrel服務(wù)器的偵聽(tīng)地址 14
1.5.10  通過(guò)HTTP.sys配置URL 15
1.5.11  PreferHostingUrls()方法的作用 15
1.6  應(yīng)用程序生命周期事件 16
第2章  運(yùn)行環(huán)境 18
2.1  定義運(yùn)行環(huán)境 18
2.2  Is{EnvironmentName}擴(kuò)展方法 19
2.3  多運(yùn)行環(huán)境下的配置文件 21
2.4  用于環(huán)境篩選的Razor標(biāo)記 23
2.5  運(yùn)行環(huán)境與依賴(lài)注入 25
第3章  依賴(lài)注入 28
3.1  依賴(lài)注入與服務(wù)容器 28
3.1.1  ServiceCollection類(lèi) 31
3.1.2  ServiceProvider類(lèi) 32
3.2  .NET項(xiàng)目中的依賴(lài)注入 32
3.3  ASP.NET Core項(xiàng)目中的依賴(lài)注入 33
3.4  構(gòu)建存在依賴(lài)關(guān)系的服務(wù) 35
3.5  服務(wù)的生存期 38
3.6  GetService()方法與GetRequiredService()方法的區(qū)別 41
3.7  注入多個(gè)服務(wù)實(shí)例 42
3.8  容易被忽略的問(wèn)題 46
第4章  配置應(yīng)用程序 48
4.1  配置的基本結(jié)構(gòu) 48
4.2  在.NET應(yīng)用程序中使用配置 49
4.3  在ASP.NET Core應(yīng)用程序中使用配置 51
4.3.1  配置的數(shù)據(jù)來(lái)源 51
4.3.2  查看所有配置信息 51
4.4  IConfigurationBuilder接口 52
4.5  ConfigurationManager類(lèi) 53
4.6  IConfigurationSource接口與IConfigurationProvider接口 54
4.6.1  自定義擴(kuò)展點(diǎn) 55
4.6.2  示例：來(lái)自CSV文件的配置 56
4.7  JSON配置 59
4.7.1  示例：訪問(wèn)JSON數(shù)組對(duì)象 62
4.7.2  示例：自動(dòng)重新加載配置 63
4.8  XML配置 64
4.9  環(huán)境變量 67
4.9.1  設(shè)置環(huán)境變量前綴 68
4.9.2  替換默認(rèn)的ASPNETCORE_前綴 70
4.9.3  示例：替換環(huán)境變量前綴 70
4.9.4  分層配置結(jié)構(gòu) 71
4.10  命令行參數(shù) 72
4.11  ini配置 75
4.12  配置與依賴(lài)注入 78
4.12.1  示例：將IConfiguration注入MVC控制器 78
4.12.2  示例：通過(guò)配置選擇哈希算法 79
4.13  鏈接多棵配置樹(shù) 82
第5章  選項(xiàng)模式 85
5.1  選項(xiàng)模式概述 85
5.2  服務(wù)容器的擴(kuò)展方法 87
5.3  各接口之間的關(guān)系 87
5.3.1  IConfigureOptions接口與IConfigureNamedOptions接口 87 5.3.2  IPostConfigureOptions接口 88 5.3.3  IValidateOptions接口 88 5.3.4  IOptionsFactory接口 89 5.3.5  完整的流程圖 90
5.4  選項(xiàng)類(lèi)的封裝接口 91
5.4.1  示例：在MVC控制器中訪問(wèn)選項(xiàng)類(lèi) 92
5.4.2  示例：自動(dòng)更新選項(xiàng)類(lèi) 93
5.5  帶名稱(chēng)的選項(xiàng)組 95
5.6  后期配置 98
5.7  選項(xiàng)類(lèi)的驗(yàn)證 99
5.7.1  內(nèi)置的驗(yàn)證方式 100
5.7.2  使用數(shù)據(jù)批注 102
5.8  處理帶參數(shù)的構(gòu)造函數(shù) 105
5.9  直接實(shí)現(xiàn)IOptions接口 108
第6章  HTTP管道 110
6.1  HTTP管道與中間件 110
6.2  中間件的實(shí)現(xiàn)方法 110
6.3  通過(guò)委托實(shí)現(xiàn)中間件 111
6.3.1  示例：Use()方法的簡(jiǎn)單用法 114
6.3.2  HTTP管道的“短路” 115
6.3.3  Run()方法 116
6.4  通過(guò)類(lèi)實(shí)現(xiàn)中間件 117
6.4.1  帶參數(shù)的中間件 118
6.4.2  中間件類(lèi)與依賴(lài)注入 119
6.5  通過(guò)IMiddleware接口實(shí)現(xiàn)中間件 120
6.6  終結(jié)點(diǎn) 121
6.6.1  示例：常見(jiàn)的HTTP請(qǐng)求方式 123
6.6.2  示例：同時(shí)使用Razor Pages和MVC 125
6.6.3  為終結(jié)點(diǎn)分配名稱(chēng) 127
6.6.4  元數(shù)據(jù) 129
6.7  有條件地執(zhí)行中間件 130
6.7.1  示例：調(diào)用包含user_id字段的中間件 131
6.7.2  示例：只允許以POST方式調(diào)用Web API 132
第7章  HTTP狀態(tài)存儲(chǔ) 135
7.1  HTTP上下文 135
7.1.1  示例：在中間件中設(shè)置響應(yīng)標(biāo)頭 136
7.1.2  示例：在Map*()方法中訪問(wèn)HTTP上下文 137
7.1.3  示例：使用Razor標(biāo)記呈現(xiàn)HTTP請(qǐng)求標(biāo)頭 138
7.1.4  示例：在MVC中訪問(wèn)HTTP上下文 140
7.2  HTTP消息頭 141
7.2.1  HeaderNames類(lèi) 143
7.2.2  消息頭的分類(lèi) 144
7.2.3  分析復(fù)雜消息頭 145
7.3  查詢(xún)字符串 148
7.3.1  讀取查詢(xún)參數(shù) 149
7.3.2  多值參數(shù) 150
7.4  表單數(shù)據(jù) 151
7.4.1  讀取簡(jiǎn)單的表單數(shù)據(jù) 151
7.4.2  文件上傳 153
7.5  Cookie 157
7.6  HttpContext類(lèi)的Items屬性 159
7.7  會(huì)話 160
7.7.1  ISession接口 161
7.7.2  設(shè)置會(huì)話Cookie的名稱(chēng) 164
7.7.3  示例：將會(huì)話數(shù)據(jù)存儲(chǔ)到JSON文件中 164
第8章  Razor頁(yè)面 172
8.1  Razor頁(yè)面的特點(diǎn) 172
8.2  Razor語(yǔ)法 173
8.2.1  兩種表達(dá)式 173
8.2.2  代碼塊 174
8.2.3  注釋 175
8.2.4  流程控制 176
8.3  開(kāi)啟Razor頁(yè)面功能 177
8.4  Razor頁(yè)面文件 178
8.5  頁(yè)面文件的搜索路徑 179
8.5.1  配置RazorPagesOptions選項(xiàng)類(lèi) 180
8.5.2  便捷的擴(kuò)展方法 180
8.6  頁(yè)面路由 181
8.6.1  通過(guò)@page指令設(shè)置路由規(guī)則 181
8.6.2  通過(guò)約定模型定義路由規(guī)則 182
8.7  頁(yè)面模型類(lèi) 184
8.7.1  頁(yè)面自身作為模型類(lèi) 185
8.7.2  從PageModel派生類(lèi) 185
8.7.3  通過(guò)特性類(lèi)實(shí)現(xiàn)頁(yè)面模型類(lèi) 186
8.8  頁(yè)面處理程序 187
8.8.1  通用的處理程序 188
8.8.2  解決POST請(qǐng)求時(shí)出現(xiàn)的錯(cuò)誤 189
8.8.3  使用多個(gè)處理程序 190
8.8.4  通過(guò)路由參數(shù)選擇處理程序 192
8.8.5  自定義的處理程序模型 193
第9章  MVC框架 199
9.1  MVC基本概念 199
9.2  啟用MVC功能 199
9.3  控制器 200
9.3.1  示例：從ControllerBase類(lèi)派生 203
9.3.2  示例：從Controller類(lèi)派生 205
9.3.3  示例：使用ControllerAttribute 205
9.3.4  示例：使用Controller后綴 206
9.3.5  自定義控制器的名稱(chēng) 207
9.3.6  示例：ControllerNameAttribute類(lèi) 207
9.3.7  自定義操作方法的名稱(chēng) 208
9.3.8  示例：CustActionNameAttribute類(lèi) 208
9.3.9  示例：ActionNameAttribute類(lèi) 209
9.4  MVC路由規(guī)則 210
9.4.1  全局路由規(guī)則 211
9.4.2  示例：注冊(cè)兩條全局路由規(guī)則 211
9.4.3  局部路由規(guī)則 212
9.4.4  IRouteTemplateProvider接口 213
9.4.5  通過(guò)實(shí)現(xiàn)約定接口定義路由規(guī)則 214
9.4.6  示例：CustPrefixRouteConvention類(lèi) 215
9.5  限制操作方法所支持的HTTP請(qǐng)求 217
9.5.1  示例：只支持HTTP-PUT請(qǐng)求的操作方法 217
9.5.2  內(nèi)置特性類(lèi) 218
9.6  區(qū)域 220
9.7  視圖 221
9.7.1  視圖文件的默認(rèn)存放路徑 221
9.7.2  自定義視圖的路徑格式 222
9.7.3  布局視圖 225
9.7.4  示例：布局視圖的查找順序 226
9.7.5  示例：配置Razor Pages布局視圖的查找路徑 229
9.7.6  _ViewImports與_ViewStart文件 231
9.7.7  示例：_ViewStart文件的替換行為 232
9.8  IViewLocationExpander接口 233
9.8.1  示例：多版本視圖 234
9.8.2  示例：根據(jù)URL查詢(xún)參數(shù)擴(kuò)展視圖路徑 237
9.8.3  LanguageViewLocationExpander類(lèi) 240
9.9  局部視圖 242
9.9.1  示例：成績(jī)單 243
9.9.2  示例：導(dǎo)航欄 246
9.10  視圖組件 248
9.10.1  示例：一個(gè)簡(jiǎn)單的視圖組件 249
9.10.2  視圖文件的查找路徑 250
9.10.3  示例：帶參數(shù)的視圖組件 251
9.10.4  通過(guò)標(biāo)記幫助器調(diào)用視圖組件 253
9.10.5  示例：Greeting視圖組件 254
9.10.6  示例：在MVC控制器中調(diào)用視圖組件 255
9.10.7  兩個(gè)特性類(lèi) 255
9.11  識(shí)別其他程序集中的控制器 256
9.11.1  示例：使用ApplicationPartAttribute類(lèi) 256
9.11.2  示例：使用AddApplicationPart()擴(kuò)展方法 257
9.11.3  示例：使用ApplicationPartManager類(lèi) 259
第10章  模型綁定 261
10.1  概述 261
10.2  自動(dòng)綁定 262
10.2.1  示例：計(jì)算器 263
10.2.2  示例：綁定數(shù)組類(lèi)型的數(shù)據(jù) 264
10.2.3  示例：綁定復(fù)雜類(lèi) 266
10.2.4  多個(gè)參數(shù)的模型綁定 268
10.2.5  示例：綁定3個(gè)參數(shù) 268
10.2.6  字典類(lèi)型的模型綁定 270
10.2.7  示例：綁定字典數(shù)據(jù) 270
10.2.8  示例：綁定IFormCollection類(lèi)型 272
10.2.9  示例：MD5計(jì)算器 273
10.2.10  綁定IFormFile和IFormFileCollection類(lèi)型 274
10.2.11  示例：上傳一個(gè)文本文件 275
10.2.12  示例：上傳多個(gè)文件 276
10.3  設(shè)置模型綁定的來(lái)源 278
10.3.1  示例：綁定HTTP消息頭 278
10.3.2  示例：從HTTP消息正文提取數(shù)據(jù) 279
10.3.3  示例：與路由參數(shù)綁定 280
10.3.4  示例：FromServices特性的使用 280
10.3.5  示例：混合使用From*特性類(lèi) 282
10.3.6  示例：將From*特性類(lèi)應(yīng)用于屬性成員 283
10.4  自定義IValueProvider接口 284
10.4.1  示例：由自定義字符串提供的值 285
10.4.2  示例：CookieValueProvider 288
10.5  IModelBinder接口 292
10.5.1  內(nèi)置綁定器 293
10.5.2  示例：AddressInfoModelBinder類(lèi) 294
10.6  BindRequiredAttribute類(lèi)與BindNeverAttribute類(lèi) 296
10.7  綁定到屬性成員 299
10.7.1  示例：控制器的屬性綁定 299
10.7.2  示例：PageModel中的屬性綁定 300
10.7.3  示例：CancellationToken類(lèi)型的屬性綁定 302
第11章  Web API 305
11.1  Web API基礎(chǔ) 305
11.1.1  ControllerBase類(lèi)與Controller類(lèi) 305
11.1.2  ApiController特性 306
11.1.3  示例：一個(gè)簡(jiǎn)單的Web API 306
11.1.4  示例：以POST方式提交數(shù)據(jù) 308
11.2  XML格式 310
11.2.1  示例：常規(guī)的XML序列化方案 311
11.2.2  示例：使用XmlDataContractSerializer方案 314
11.3  選擇響應(yīng)格式 316
11.3.1  示例：通過(guò)Accept消息頭選擇響應(yīng)格式 316
11.3.2  示例：使用格式過(guò)濾器 317
11.4  自定義格式 319
11.4.1  示例：CustDataInputFormatter類(lèi) 319
11.4.2  示例：BytesToHexOutputFormatter類(lèi) 323
11.5  極小API 325
11.5.1  示例：一些簡(jiǎn)單的極小API例子 325
11.5.2  示例：在極小API上使用數(shù)據(jù)源特性 327
11.5.3  上傳文件 328
11.5.4  示例：直接讀取文件流 328
11.5.5  示例：上傳多個(gè)文件 330
11.5.6  IResult接口 332
11.5.7  示例：Results類(lèi)的使用 333
11.6  API瀏覽功能 333
11.6.1  IApiDescriptionGroupCollectionProvider接口 334
11.6.2  示例：列出已定義的Web API 334
11.6.3  API約定 337
11.6.4  Swagger框架 339
11.6.5  示例：使用Swagger生成API文檔 340
第12章  過(guò)濾器 343
12.1  過(guò)濾器的執(zhí)行過(guò)程 343
12.1.1  示例：觀察過(guò)濾器的運(yùn)行順序 344
12.1.2  示例：同時(shí)實(shí)現(xiàn)多個(gè)接口 348
12.2  過(guò)濾器的作用域 349
12.2.1  示例：全局過(guò)濾器 349
12.2.2  示例：特性化的過(guò)濾器 350
12.3  在Razor Pages中使用過(guò)濾器 352
12.3.1  示例：在Razor標(biāo)記頁(yè)和頁(yè)面模型類(lèi)上應(yīng)用過(guò)濾器 352
12.3.2  示例：在Razor Pages中應(yīng)用全局過(guò)濾器 353
12.3.3  頁(yè)面處理程序的過(guò)濾器 354
12.3.4  示例：實(shí)現(xiàn)IPageFilter接口 354
12.4  異步過(guò)濾器接口 355
12.4.1  示例：實(shí)現(xiàn)異步授權(quán)過(guò)濾器 356
12.4.2  示例：實(shí)現(xiàn)異步資源過(guò)濾器 356
12.5  IAlwaysRunResultFilter接口 358
12.6  IFilterFactory接口 360
12.6.1  示例：訪問(wèn)服務(wù)容器中的過(guò)濾器 360
12.6.2  示例：使用TypeFilterAttribute類(lèi)創(chuàng)建過(guò)濾器實(shí)例 361
12.6.3  示例：使用ServiceFilterAttribute類(lèi)訪問(wèn)服務(wù)容器中的過(guò)濾器 363
12.7  過(guò)濾器的運(yùn)行順序 364
12.7.1  示例：過(guò)濾器的作用域與運(yùn)行順序 364
12.7.2  示例：自定義過(guò)濾器的運(yùn)行順序 368
12.8  抽象的過(guò)濾器特性類(lèi) 369
12.8.1  示例：重寫(xiě)ActionFilterAttribute類(lèi) 370
12.8.2  示例：重寫(xiě)ExceptionFilterAttribute類(lèi) 371
第13章  標(biāo)記幫助器 372
13.1  標(biāo)記幫助器簡(jiǎn)介 372
13.1.1  示例：為標(biāo)記添加“加粗”功能 373 13.1.2  示例：標(biāo)記幫助器 374 13.1.3  示例：使用標(biāo)記幫助器設(shè)置HTML元素的文本樣式 375
13.2  將標(biāo)記幫助器注冊(cè)到服務(wù)容器 377
13.3  內(nèi)置的標(biāo)記幫助器 380
13.3.1  示例：緩存當(dāng)前時(shí)間 380
13.3.2  示例：用元素提交表單 381 13.3.3  示例：asp-for屬性的使用 382
13.3.4  示例：呈現(xiàn)驗(yàn)證信息 384
13.4  標(biāo)記幫助器組件 386
13.4.1  示例：在元素內(nèi)插入CSS樣式 387 13.4.2  示例：使用ITagHelperComponentManager對(duì)象注冊(cè)標(biāo)記幫助器組件 389
第14章  靜態(tài)文件 392
14.1  靜態(tài)文件簡(jiǎn)介 392
14.2  使用靜態(tài)文件 393
14.2.1  示例：訪問(wèn)圖像文件 393
14.2.2  示例：修改WEBROOT路徑 395
14.2.3  示例：統(tǒng)計(jì)輸入的字符數(shù)量 397
14.2.4  示例：合并多個(gè)目錄 398
14.3  目錄瀏覽 400
14.3.1  示例：瀏覽外部目錄 401
14.3.2  示例：自定義文件類(lèi)型映射 401
14.4  文件服務(wù) 410
第15章  路由約束 412
15.1  路由約束的作用 412
15.2  IRouteConstraint接口 412
15.3  內(nèi)置的路由約束 413
15.3.1  示例：雙精度數(shù)值約束 415
15.3.2  示例：限制字符串長(zhǎng)度 415
15.3.3  示例：特定格式的訂單號(hào) 416
15.3.4  示例：限制整數(shù)值的范圍 417
15.4  自定義路由約束 417
第16章  SignalR 419
16.1  WebSocket 419
16.1.1  示例：用JavaScript實(shí)現(xiàn)客戶(hù)端 419
16.1.2  示例：用.NET控制臺(tái)實(shí)現(xiàn)WebSocket客戶(hù)端 422
16.1.3  子協(xié)議 424
16.2  SignalR基礎(chǔ) 427
16.2.1  SignalR中心 428
16.2.2  示例：簡(jiǎn)易計(jì)算器 428
16.2.3  示例：使用面向.NET的SignalR庫(kù) 430
16.3  調(diào)用客戶(hù)端 433
16.3.1  示例：聊天室 433
16.3.2  將客戶(hù)端定義為接口 435
16.3.3  示例：實(shí)時(shí)更新進(jìn)度條 436
16.3.4  示例：記錄連接狀態(tài) 438
第17章  Blazor 442
17.1  Blazor概述 442
17.2  服務(wù)器托管 443
17.2.1  示例：使用Razor Pages承載Blazor應(yīng)用 444
17.2.2  示例：在MVC視圖中承載Blazor應(yīng)用 446
17.2.3  初始化腳本 448
17.2.4  示例：使用初始化腳本 449
17.2.5  示例：手動(dòng)添加modules.json文件 450
17.3  WebAssembly托管 451
17.3.1  示例：手動(dòng)創(chuàng)建Blazor WebAssembly項(xiàng)目 452
17.3.2  示例：用node.js開(kāi)發(fā)Blazor WebAssembly服務(wù)器 454
17.3.3  示例：初始化腳本 457
17.3.4  DevServer 458
17.4  路由組件 459
17.4.1  示例：路由組件的簡(jiǎn)單應(yīng)用 460
17.4.2  示例：使用路由參數(shù) 461
17.4.3  示例：使用[Route]特性 463
17.5  布局組件 463
17.5.1  示例：導(dǎo)航欄 464
17.5.2  示例：將普通組件用于布局 466
17.6  組件參數(shù) 466
17.6.1  示例：嵌套組件的參數(shù)傳遞 466
17.6.2  示例：頂層組件的參數(shù)傳遞（Blazor Server） 467
17.6.3  示例：頂層組件的參數(shù)傳遞（Blazor WebAssembly） 468
17.7  級(jí)聯(lián)參數(shù) 469
17.7.1  示例：根據(jù)類(lèi)型接收級(jí)聯(lián)參數(shù) 469
17.7.2  示例：根據(jù)命名接收級(jí)聯(lián)參數(shù) 472
17.8  事件 473
17.8.1  示例：計(jì)數(shù)器 476
17.8.2  示例：記錄鼠標(biāo)指針的位置 476
17.8.3  EventCallback結(jié)構(gòu)體 477
17.8.4  示例：進(jìn)度條組件 478
17.9  CSS隔離 480
17.10  數(shù)據(jù)綁定 482
17.10.1  示例：綁定日期輸入元素 483
17.10.2  示例：使用oninput事件 483
17.10.3  組件之間的綁定 484
17.10.4  示例：Slider組件 485
17.11  用.NET代碼編寫(xiě)組件 486
17.11.1  渲染樹(shù) 487
17.11.2  示例：用.NET代碼實(shí)現(xiàn)App和Index組件 488
17.11.3  示例：使用依賴(lài)注入 491
17.12  .NET與JavaScript互操作 493
17.12.1  示例：調(diào)用JavaScript中的alert()方法 494
17.12.2  示例：調(diào)用QRCode.js生成二維碼 494
17.12.3  示例：階乘計(jì)算器 496
17.12.4  示例：JavaScript調(diào)用.NET對(duì)象的實(shí)例方法 497
第18章  驗(yàn)證與授權(quán) 500
18.1  驗(yàn)證與授權(quán)的關(guān)系 500
18.2  與驗(yàn)證有關(guān)的核心服務(wù) 501
18.3  驗(yàn)證處理程序 501
18.3.1  示例：驗(yàn)證HTTP消息頭 502
18.3.2  示例：多個(gè)驗(yàn)證方案共用一個(gè)IAuthenticationHandler接口 505
18.4  IAuthenticationSignInHandler接口 508
18.5  驗(yàn)證中間件 515
18.6  授權(quán)處理程序與必要條件 519
18.6.1  示例：允許指定的部門(mén)訪問(wèn) 520
18.6.2  PassThroughAuthorizationHandler類(lèi) 522
18.7  授權(quán)策略 525
18.7.1  示例：按用戶(hù)星級(jí)授權(quán) 525
18.7.2  示例：集成內(nèi)置的Cookie驗(yàn)證 529
18.7.3  示例：在終結(jié)點(diǎn)上應(yīng)用授權(quán)策略 534