ASP.NET Core 1.0 入門——Application Startup__.net

提示

更新時間：2016年01月20日。 Startup 類

在 ASP.NET Core 1.0 中，Startup 類是一個應用的進入點，我們可以為不同環境配置不同的內容。

編譯器會尋找專案檔夾下的所有 *.cs 檔案進行編譯，而運行時會尋找所有命名空間下類名為 Startup 的類作為啟動方式。

註解

可以通過設定 project.json 檔案選擇需要（或不需要）編譯的檔案和檔案夾；也可以設定在不同的程式集中搜尋 Startup 類。

Startup 類必須定義一個 Configure 方法，也可以同時定義一個 ConfigureServices 方法。 Startup 類的建構函式

建構函式，可以幫我們設定設定檔的位置，比如下面的代碼設定了 appsettings.json 。

public Startup(IHostingEnvironment env){    // 設定 設定檔 的位置    var builder = new ConfigurationBuilder()        .AddJsonFile("appsettings.json")        .AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true);    if (env.IsDevelopment())    {        // For more details on using the user secret store see http://go.microsoft.com/fwlink/?LinkID=532709        builder.AddUserSecrets();    }    builder.AddEnvironmentVariables();    Configuration = builder.Build();}

預設的 appsettings.json 內容如下：

{  "Logging": {    "IncludeScopes": false,    "LogLevel": {      "Default": "Verbose",      "System": "Information",      "Microsoft": "Information"    }  }}

ConfigureServices 方法

ConfigureServices 用來定義我們使用了哪些服務，比如MVC、EF、Identity、Logging、Route；也可以自訂一些服務。 這裡定義的服務是基於依賴注入(Dependency Injection)的。 在ASP.NET Core 1.0中，依賴注入技術的是被大量使用的。

下面的例子中，配置了EntityFramework（用於資料訪問，需要在 appsettings.json 中正確設定連接字串）、Identity（用於身分識別驗證/即登入）和MVC。

public void ConfigureServices(IServiceCollection services){    // Add framework services.    services.AddEntityFramework()        .AddSqlServer()        .AddDbContext<ApplicationDbContext>(options =>            options.UseSqlServer(Configuration["Data:DefaultConnection:ConnectionString"]));    services.AddIdentity<ApplicationUser, IdentityRole>()        .AddEntityFrameworkStores<ApplicationDbContext>()        .AddDefaultTokenProviders();    services.AddMvc();    // Add application services.    services.AddTransient<IEmailSender, AuthMessageSender>();    services.AddTransient<ISmsSender, AuthMessageSender>();}

在調用過 ConfigureServices 之後，運行時會調用 Configure 方法。 Configure 方法

Configure 方法用於載入各種需要的中介軟體，類似於傳統的 OWIN（Open Web Interface for .NET）。 Configure 方法簽名必須包含 IApplicationBuilder 的參數，也可以包含一些其他的五福 IHostingEnvironment和 ILoggerFactory 的參數。

public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory){    //在控制台中輸出log    loggerFactory.AddConsole(Configuration.GetSection("Logging"));    loggerFactory.AddDebug();    //在開發環境下，顯示錯誤詳細資料    if (env.IsDevelopment())    {        app.UseBrowserLink();        app.UseDeveloperExceptionPage();        app.UseDatabaseErrorPage();    }    else    {        //否則，導向錯誤頁面        app.UseExceptionHandler("/Home/Error");        // 建立資料庫        try        {            using (var serviceScope = app.ApplicationServices.GetRequiredService<IServiceScopeFactory>()                .CreateScope())            {                serviceScope.ServiceProvider.GetService<ApplicationDbContext>()                    .Database.Migrate();            }        }        catch { }    }    app.UseIISPlatformHandler(options => options.AuthenticationDescriptions.Clear());    //允許訪問wwwroot檔案夾下的靜態檔案    app.UseStaticFiles();    //設定身分識別驗證方式    app.UseIdentity();    // 設定MVC路由    app.UseMvc(routes =>    {        routes.MapRoute(            name: "default",            template: "{controller=Home}/{action=Index}/{id?}");    });}

警告

設定MVC的路由方式必須在 Configure 中設定，僅在 ConfigureServices 中設定是無效的。