​​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 中间件。


作者：沐雪

文章均系作者原创或翻译，如有错误不妥之处，欢迎各位批评指正。本文版权归作者所有，如需转载恳请注明。
​​​ 为之网-热爱软件编程 http://www.weizhi.cc/​​