.NET CORE應用程序啓動

ASP.NET Core 應用是在其 Main 方法中建立 Web 服務器的控制檯應用: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 請求。app

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類配置服務和請求管道ui

Statusup類包括ConfigureServices方法以配置應用的服務.Configure方法以建立應用的請求處理管道this

在 Startup 類中注入依賴關係的常見用途爲注入:spa

  • 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 中間件,請在將庫添加到服務容器以前定位服務註冊。 若要在此後調用,請在添加庫以後定位服務註冊。

相關文章
相關標籤/搜索