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)
}
// 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 并将其直接傳遞到 管道 。
使用Use擴充方法将中間件元件添加到請求管道,
使用Startup篩選器擴充Startup
在應用的 Configure 中間件管道的開頭或末尾使用 IStartupFilter 來配置中間件。 IStartupFilter 有助于確定
中間件在應用請求處理管道的開始或結束時由庫添加的中間件之前或之後運作
IStartupFilter 實作單個方法(即 Configure),該方法接收并傳回 Action<IApplicationBuilder> 。
IApplicationBuilder 定義用于配置應用請求管道的類。 有關詳細資訊,請參閱使用 IApplicationBuilder 建立中
間件管道。
在請求管道中,每個 IStartupFilter 實作一個或多個中間件。 篩選器按照添加到服務容器的順序調用。 篩選
器可在将控件傳遞給下一個篩選器之前或之後添加中間件,進而附加到應用管道的開頭或末尾。
IApplicationBuilder 定義用于配置應用請求管道的類。
IStartupFilter 在 IWebHostBuilder.ConfigureServices 中的服務容器中注冊
中間件執行順序由 IStartupFilter 注冊順序設定:
多個 IStartupFilter 實作可能與相同的對象進行互動。 如果順序很重要,請将它們的 IStartupFilter 服
務注冊進行排序,以比對其中間件應有的運作順序。
庫可能添加包含一個或多個 IStartupFilter 實作的中間件,這些實作在向 IStartupFilter 注冊的其他應
用中間件之前或之後運作。 若要在庫的 IStartupFilter 添加中間件之前調用 IStartupFilter 中間件,請
在将庫添加到服務容器之前定位服務注冊。 若要在此後調用,請在添加庫之後定位服務注冊。