ASP.NET Core 應用是在其 Main 方法中創建 Web 伺服器的控制台應用: Main 方法調用 WebHost.CreateDefaultBuilder,通過生成器模式來創建web主機.生成器提供定義 Web 伺服器(例如,UseKestrel)和啟動類 (UseStartup) 的方 ...
ASP.NET Core 應用是在其 Main 方法中創建 Web 伺服器的控制台應用:
Main 方法調用 WebHost.CreateDefaultBuilder,通過生成器模式來創建web主機.生成器提供定義 Web 伺服器(例如,UseKestrel)和啟動類 (UseStartup) 的方法。 在前面的例子中,自動分配了 Kestrel Web 伺服器。ASP.NET Core 的 Web 主機嘗試在 IIS 上運行(如果可用)。 對於其他 Web 伺服器(如 HTTP.sys),可通過調用相應的擴展方法來使用。 在下一節對 UseStartup 進行了更深入的介紹。
IWebHostBuilder 是 WebHost.CreateDefaultBuilder 調用的返回類型,它提供了許多可選方法。 其中的一些方法包括用於在 HTTP.sys 中托管應用的 UseHttpSys ,以及用於指定根內容目錄的 UseContentRoot。 Build 和 Run 方法生成 IWebHost 對象,該對象托管應用並開始偵聽 HTTP 請求。
WebHostBuilder 提供了許多可選方法,其中包括用於在 IIS 和 IIS Express 中進行托管的 UseIISIntegration,以及用於指定根內容目錄的 UseContentRoot。 Build 和 Run 方法生成 IWebHost 對象,該對象托管應用並開始偵聽HTTP 請求。
Startup 類用於定義請求處理管道和配置應用所需的任何服務
ConfigureServices 定義應用所使用的服務(如 ASP.NET Core MVC、Entity Framework Core 和標識)。 Configure定義在請求管道中調用的中間件。
public class Startup { // This method gets called by the runtime. Use this method // to add services to the container. public void ConfigureServices(IServiceCollection services) { } // This method gets called by the runtime. Use this method // to configure the HTTP request pipeline. public void Configure(IApplicationBuilder app) { } }
- 內容:如 Razor Pages、MVC 視圖和靜態資源
- Web根:包含公共資源、CSS 等靜態資源、JavaScript 和圖形文件。
- 依賴關係註入服務:服務是應用中常用的組件。 可以通過依存關係註入 (DI) 來獲取服務。 ASP.NET Core 包括預設支持構造函數註入的本機控制反轉 (IoC) 容器。 可根據需要替換預設容器。 DI 除了具備鬆散耦合優勢以外,還可以使服務(例如日誌記錄)在整個應用中可用。
- 中間件:在 ASP.NET Core 中,使用中間件來撰寫請求管道。 ASP.NET Core 中間件在 HttpContext 上執行非同步操作,然後調用管道中的下一個中間件或終止請求。按照慣例,通過在 Configure 方法中調用 UseXYZ 擴展方法,向管道添加名為“XYZ”的中間件組件。ASP.NET Core 包含一組豐富的內置中間件,你也可以編寫自己的自定義中間件。 ASP.NET Core 應用中支持 .NET的開放 Web 介面 (OWIN),它將 Web 應用與 Web 伺服器分離。
- HTTP啟動請求:IHttpClientFactory 可訪問 HttpClient 實例以發出 HTTP 請求。
- 環境:環境(如“開發”環境和“生產”環境)是 ASP.NET Core 的高級概念,可使用環境變數、設置文件和命令行參數進行設置。
- ASP.NET Core 應用可配置和啟動一個主機,負責應用啟動和生存期管理。
- 伺服器:ASP.NET Core 托管模型不直接偵聽請求。 托管模型依賴 HTTP 伺服器實現將請求轉發到應用。 轉發的請求被打包為一組可通過介面進行訪問的功能對象。 ASP.NET Core 包含托管的跨平臺 Web 伺服器,名為 Kestrel。 Kestrel通常在生產 Web 伺服器(如反向代理配置中的 IIS 或 Nginx)後臺運行。
- 配置:基於名稱/值對使用配置模型,不再是system.Configuration和web.config。配置從一組有序的配置提供程式獲取設置。 內置配置提供程式支持各種文件格式(XML、 JSON、INI)、環境變數和命令行參數。 也可以編寫你自己的自定義配置提供程式。
- 日誌記錄:ASP.NET Core 支持適用於各種日誌記錄提供程式的日誌記錄 API。 內置提供程式支持向一個或多個目標發送日誌。 可使用第三方記錄框架。
- 錯誤處理:ASP.NET Core 的內置方案可處理應用中的錯誤,包括開發人員異常頁、自定義錯誤頁、靜態狀態代碼頁和啟動異常處理。
- 路由
- 文件處理
- 靜態文件
- 會話和應用狀態:ASP.NET Core 提供幾種可在用戶瀏覽 web 應用時保留會話和應用狀態的方法。
- 請求功能:與HTTP請求和響應相關的Web伺服器實現詳細信息在介面中定義,伺服器實現和中間件使用這些介面來創建和修改應用的托管管道。
- 後臺任務:後臺任務作為托管服務實現。 托管服務是一個類,具有實現 IHostedService 介面的後臺任務邏輯。
- WebSockets:WebSocket 是一個協議,支持通過 TCP 連接建立持久的雙向通道。 它可用於聊天、股票報價和游戲等應用,以及Web 應用中需要實時功能的任何位置。 ASP.NET Core 支持 Web 套接字方案。
Statusup類配置服務和請求管道
Statusup類包括ConfigureServices方法以配置應用的服務.Configure方法以創建應用的請求處理管道
在 Startup 類中註入依賴關係的常見用途為註入:
- IHostingEnvironment 以按環境配置服務。
- IConfiguration 以讀取配置。
- ILoggerFactory 以在 Startup.ConfigureServices 中創建記錄器。
private readonly IHostingEnvironment _env; private readonly IConfiguration _config; private readonly ILoggerFactory _loggerFactory; public Startup(IHostingEnvironment env, IConfiguration config, ILoggerFactory loggerFactory) { _env = env; _config = config; _loggerFactory = loggerFactory; }
ConfigureServices方法
- Optional
- 在 Configure 方法配置應用服務之前,由 Web 主機調用。
- 其中按常規設置配置選項。
調用所有Add{Service}方法,然後調用所有services.Configure{Service}方法。
將服務添加到服務容器,使其應用和Config方法中可用,這些服務是通過依賴關係註入或IApplicationBuilder.ApplicationServices 解析。
Configure方法
configure方法用於指定應用響應HTTP請求的方式。可通過將中間件組件添加到IApplicationBuilder實例來配置請求管道。Configure 方法可使用 IApplicationBuilder ,但未在服務容器中註冊。 托管創建IApplicationBuilder 並將其直接傳遞到 管道 。Configure 方法可使用 IApplicationBuilder ,但未在服務容器中註冊。 托管創建IApplicationBuilder 並將其直接傳遞到 Configure 。
使用Use擴展方法將中間件組件添加到請求管道,
使用Startup篩選器擴展Startup
在應用的 Configure 中間件管道的開頭或末尾使用 IStartupFilter 來配置中間件。 IStartupFilter 有助於確保
中間件在應用請求處理管道的開始或結束時由庫添加的中間件之前或之後運行
IStartupFilter 實現單個方法(即 Configure),該方法接收並返回 Action<IApplicationBuilder> 。
IApplicationBuilder 定義用於配置應用請求管道的類。 有關詳細信息,請參閱使用 IApplicationBuilder 創建中
間件管道。
在請求管道中,每個 IStartupFilter 實現一個或多個中間件。 篩選器按照添加到服務容器的順序調用。 篩選
器可在將控制項傳遞給下一個篩選器之前或之後添加中間件,從而附加到應用管道的開頭或末尾。
IStartupFilter 實現單個方法(即 Configure),該方法接收並返回 Action<IApplicationBuilder> 。
IApplicationBuilder 定義用於配置應用請求管道的類。
IStartupFilter 在 IWebHostBuilder.ConfigureServices 中的服務容器中註冊
中間件執行順序由 IStartupFilter 註冊順序設置:
多個 IStartupFilter 實現可能與相同的對象進行交互。 如果順序很重要,請將它們的 IStartupFilter 服
務註冊進行排序,以匹配其中間件應有的運行順序。
庫可能添加包含一個或多個 IStartupFilter 實現的中間件,這些實現在向 IStartupFilter 註冊的其他應
用中間件之前或之後運行。 若要在庫的 IStartupFilter 添加中間件之前調用 IStartupFilter 中間件,請
在將庫添加到服務容器之前定位服務註冊。 若要在此後調用,請在添加庫之後定位服務註冊。