Startup 类配置服务和应用的请求管道。

Startup 类

ASP.NET Core 应用使用 Startup 类，按照约定命名为 Startup。 Startup 类：

• 可选择性地包括 ConfigureServices 方法以配置应用的服务 。 服务是一个提供应用功能的可重用组件。 在 ConfigureServices 中注册服务，并通过依赖关系注入 (DI) 或 ApplicationServices 在整个应用中使用服务 。
• 包括 Configure 方法以创建应用的请求处理管道。

在应用启动时，ASP.NET Core 运行时会调用 ConfigureServices 和 Configure：

public class Startup{    public Startup(IConfiguration configuration)    {        Configuration = configuration;    }     public IConfiguration Configuration { get; }     public void ConfigureServices(IServiceCollection services)    {        services.AddRazorPages();    }     public void Configure(IApplicationBuilder app, IWebHostEnvironment env)    {        if (env.IsDevelopment())        {            app.UseDeveloperExceptionPage();        }        else        {            app.UseExceptionHandler("/Error");            app.UseHsts();        }         app.UseHttpsRedirection();        app.UseStaticFiles();         app.UseRouting();         app.UseAuthorization();         app.UseEndpoints(endpoints =>        {            endpoints.MapRazorPages();        });    }}

在构建应用主机时指定 Startup 类。 通常通过在主机生成器上调用 WebHostBuilderExtensions.UseStartup<TStartup> 方法来指定 Startup 类：

public class Program{    public static void Main(string[] args)    {        CreateHostBuilder(args).Build().Run();    }     public static IHostBuilder CreateHostBuilder(string[] args) =>        Host.CreateDefaultBuilder(args)            .ConfigureWebHostDefaults(webBuilder =>            {                webBuilder.UseStartup<Startup>();            });}

主机提供 Startup 类构造函数可用的某些服务。 应用通过 ConfigureServices 添加其他服务。 主机和应用服务都可以在 Configure 和整个应用中使用。

使用泛型主机 (IHostBuilder) 时，只能将以下服务类型注入 Startup 构造函数：

• IWebHostEnvironment
• IHostEnvironment
• IConfiguration
  

  public class Program{    public static void Main(string[] args)    {        CreateHostBuilder(args).Build().Run();    }     public static IHostBuilder CreateHostBuilder(string[] args) =>        Host.CreateDefaultBuilder(args)            .ConfigureWebHostDefaults(webBuilder =>            {                webBuilder.UseStartup<Startup>();            });}

  ConfigureServices 方法

  ConfigureServices 方法：

  • 可选。
  • 在 Configure 方法配置应用服务之前，由主机调用。
  • 其中按常规设置配置选项。

  主机可能会在调用 Startup 方法之前配置某些服务。 有关详细信息，请参阅主机。

  对于需要大量设置的功能，IServiceCollection 上有 Add{Service} 扩展方法。 例如，AddDbContext、AddDefaultIdentity、AddEntityFrameworkStores 和 AddRazorPages：

  public class Startup{    public Startup(IConfiguration configuration)    {        Configuration = configuration;    }     public IConfiguration Configuration { get; }     public void ConfigureServices(IServiceCollection services)    {         services.AddDbContext<ApplicationDbContext>(options =>            options.UseSqlServer(                Configuration.GetConnectionString("DefaultConnection")));        services.AddDefaultIdentity<IdentityUser>(            options => options.SignIn.RequireConfirmedAccount = true)            .AddEntityFrameworkStores<ApplicationDbContext>();         services.AddRazorPages();    }

  将服务添加到服务容器，使其在应用和 Configure 方法中可用。 服务通过依赖关系注入或 ApplicationServices 进行解析。

  Configure 方法

  Configure 方法用于指定应用响应 HTTP 请求的方式。 可通过将中间件组件添加到 IApplicationBuilder 实例来配置请求管道。 Configure 方法可使用 IApplicationBuilder，但未在服务容器中注册。 托管创建 IApplicationBuilder 并将其直接传递到 Configure。

  ASP.NET Core 模板配置的管道支持：

  • 开发人员异常页
  • 异常处理程序
  • HTTP 严格传输安全性 (HSTS)
  • HTTPS 重定向
  • 静态文件
  • ASP.NET Core MVC 和 Razor Pages
    

    public class Startup{    public Startup(IConfiguration configuration)    {        Configuration = configuration;    }     public IConfiguration Configuration { get; }     public void ConfigureServices(IServiceCollection services)    {        services.AddRazorPages();    }     public void Configure(IApplicationBuilder app, IWebHostEnvironment env)    {        if (env.IsDevelopment())        {            app.UseDeveloperExceptionPage();        }        else        {            app.UseExceptionHandler("/Error");            app.UseHsts();        }         app.UseHttpsRedirection();        app.UseStaticFiles();         app.UseRouting();         app.UseAuthorization();         app.UseEndpoints(endpoints =>        {            endpoints.MapRazorPages();        });    }}

    每个 Use 扩展方法将一个或多个中间件组件添加到请求管道。 例如，UseStaticFiles 配置中间件提供静态文件。

    请求管道中的每个中间件组件负责调用管道中的下一个组件，或在适当情况下使链发生短路。

    可以在 Configure 方法签名中指定其他服务，如 IWebHostEnvironment、ILoggerFactory 或 ConfigureServices 中定义的任何内容。 如果这些服务可用，则会被注入。

    有关如何使用 IApplicationBuilder 和中间件处理顺序的详细信息，请参阅 ASP.NET Core 中间件。