作者:无心小象 | 来源:互联网 | 2024-12-25 02:13
Startup 类配置服务和应用的请求管道。Startup类ASP.NETCore应用使用 Startup 类,按照约定命名为 Startup。 Startup 类:可选择性地包括
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 方法来指定 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
类构造函数可用的某些服务。 应用通过 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();
});
}
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(optiOns=>
options.UseSqlServer(
Configuration.GetConnectionString("DefaultConnection")));
services.AddDefaultIdentity(
options => options.SignIn.RequireCOnfirmedAccount= true)
.AddEntityFrameworkStores();
services.AddRazorPages();
}
将服务添加到服务容器,使其在应用和 Configure
方法中可用。 服务通过依赖关系注入或 ApplicationServices 进行解析。
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 中间件。
ASP.NET Core 3.1 中的Startup类