ASP.NET Core 1.0 入门——Application Startup

太过爱你忘了你带给我的痛 2022-09-23 08:20 161阅读 0赞

提示

更新时间：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` 中设置是无效的。