ASP.NET Core3基础：01. 示例项目搭建与启动顺序

悦光阴 2021-03-19

展开全文

一、新建示例项目

可以通过dotnet cli和visual studio进行创建项目，这里使用vs进行新建

这里选择ASP.NET Core Web应用程序

这里选择API，并且把HTTPS的勾去掉，点击创建。选择API是以为默认已经配置好了一些设置，方便进行测试。

为了方便学习，可以下载中文语言包，具体查看官方文档：https://docs.microsoft.com/zh-cn/dotnet/core/install/localized-intellisense

二、ASP.NET Core 3的启动执行顺序

首先看 Program.cs 文件，ASP.NET Core 3本质是一个控制台应用程序，Host是一个静态类，提供使用预配置默认值创建 IHostBuilder实例的简便方法，CreateDefaultBuilder 的参数提供了通过命令行注入配置的默认实现。ConfigureWebHostDefaults 使用与配置默认值创建 IWebHostBuilder 类的实例。ConfigureWebHostDefaults 里面通过 UseStartup 配置了Startup 这个类作为启动的配置类。

using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Hosting;
namespace MyExample.DemoWebApi {
    public class Program {
        public static void Main(string[] args) {
            CreateHostBuilder(args).Build( ).Run( );
        }
        public static IHostBuilder CreateHostBuilder(string[] args) =>
            // 使用预配置默认值初始化 HostBuilder 类的新实例
            Host.CreateDefaultBuilder(args)
                .ConfigureWebHostDefaults(webBuilder => {
                    webBuilder.UseStartup<Startup>( );
                });
    }
}

接着看 Startup.cs 文件，在这里可以添加我们自己的配置。

构造方法中，注入了一个 IConfiguration 用于读取程序的配置信息，例如读取appsetting.json的配置信息，这里能用注入的方法是因为在 Program.cs 中已经默认为程序提供了一些默认的注入。

ConfigureServices 可以用来配置自定的程序服务注入，例如：EFCore的仓储注入、应用程序的配置等。一般来说不会直接在这个类下面写，而是创建一个扩展方法。

Configure 用来配置应用程序的请求管道，API项目默认已经为程序添加了以下管道：

app.UseDeveloperExceptionPage：显示异常的信息（发布到生成环境时不应该启用这个）
app.UseRouting：配置应用程序的路由
app.UseAuthorization：配置认证信息
app.UseEndpoints：匹配路由的节点，这里配置了默认实现（RESTful格式）。也可以配置为controller/action模式：endpoints.MapControllerRoute("default","{controller=Home}/{action=Index}/{id?}"); 。关于RESTful可以参考：http://www./blog/2011/09/restful.html

以上仅是很小一部分，ASP.NET Core 3有非常多的默认中间件供调用，我们也可以配置自己的中间件实现，实现自定义请求的控制。

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using System.Threading;
namespace MyExample.DemoWebApi {
    public class Startup {
        public Startup(IConfiguration configuration) {
            Configuration = configuration;
        }
        public IConfiguration Configuration { get; }
        // This method gets called by the runtime. Use this method to add services to the container.
        public void ConfigureServices(IServiceCollection services) {
            services.AddControllers( );
        }
        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IWebHostEnvironment env) {
            if (env.IsDevelopment( )) {
                app.UseDeveloperExceptionPage( );
            }
            app.UseRouting( );
            app.UseAuthorization( );
            app.UseEndpoints(endpoints => {
                // 默认实现方式：RESTful
                endpoints.MapControllers( );
            });
        }
    }
}