当前位置：首页 > article >正文

ASP.NET Core 应用程序的Startup笔记

article 2025/1/16 5:59:42

在 ASP.NET Core 中，Startup 类是用于配置应用程序的服务和请求管道的地方。

默认情况下，Visual Studio 2022 创建的 ASP.NET Core Web API 项目可能不再包含 Startup 类，而是直接在 Program.cs 中进行配置。这是因为从 .NET 6 开始，ASP.NET Core 引入了简化的宿主模型（Minimal Hosting Model），使得应用的结构更加简单。

使用 Startup 类的情况

我们可以在以下情况下使用 Startup 类：

复杂的配置需求：如果我们的应用程序需要多个配置和中间件，使用 Startup 类可以帮助我们将配置分离，结构更加清晰。
迁移旧代码：如果我们在维护一个旧版的 ASP.NET Core 应用程序（如 .NET 5 或更早版本），这些版本通常都使用 Startup 类。

Startup 类的基本结构

如果我们决定使用 Startup 类，基本结构如下：

public class Startup
{
    public Startup(IConfiguration configuration)
    {
        Configuration = configuration; // 读取配置
    }

    public IConfiguration Configuration { get; }

    public void ConfigureServices(IServiceCollection services)
    {
        // 注册服务，如数据库上下文、依赖注入等
    }

    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        // 配置中间件
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }
        else
        {
            app.UseExceptionHandler("/Home/Error"); // 错误处理
            app.UseHsts(); // 安全传输
        }

        app.UseRouting(); // 启用路由
        app.UseAuthorization(); // 启用授权

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapControllers(); // 映射控制器
        });
    }
}

在 Program.cs 中使用 Startup

如果我们的项目使用了 Startup 类，我们需要在 Program.cs 中进行引用和配置：

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 类
            });
}