ASP.NET Core 的 `Core` 有几种写法？

一、概述

本文将会根据情况持续更新。
作为一个 Framework，ASP.NET Core 提供了诸多的扩展点。使用内置的组件和默认的配置通常就能够满足部分需求，当需要扩展的时就需要先去找出这些扩展点。除了基于实际应用对 ASP.NET Core 进行扩展，也会故意搞一些不切实际的伪需求，解决一些不会存在的问题。这样的目的何在呢？一是为了加深对 ASP.NET Core 的理解，二是难保这些伪需求不会变成真需求。

二、WebHost.CreateDefaultHostBuilder

WebHost.CreateDefaultHostBuilder 静态方法用于创建 WebHostBuilder 对象，它有三个重载：

1
2
3

public static IWebHostBuilder CreateDefaultBuilder();
public static IWebHostBuilder CreateDefaultBuilder(string[] args);
public static IWebHostBuilder CreateDefaultBuilder<TStartup>(string[] args) where TStartup : class;

ASP.NET Core 项目模板使用的是第二个重载。第一个重载其实没多大必要，将第二个重载的 args 参数设置成默认为 null 也可以。使用第三个重载，可以少一次对 UseStartup<T> 的直接调用。

1 2	public static IWebHostBuilder CreateWebHostBuilder(string[] args) => WebHost.CreateDefaultBuilder<Startup>(args);

CreateDefaultBuilder 不能满足需求时，可自行通过 new 创建 WebHostBuilder 。比如 CreateDefaultBuilder 在创建 WebHostBuidler 调用了后者的 UseDefaultServiceProvider 扩展方法会导致使用默认的 DefaultServiceProviderFactory ，从而导致使用默认 DI 容器( ServiceProvider )，虽然之后可以替换成 Autofac 之类的，但可以控制直接使用而不是替换。

三、IWebHostBuilder.UseStartup

IWebHostBuilder.UseStartup 扩展方法用于使用 Startup，它有两个重载：

1
2

public static IWebHostBuilder UseStartup(this IWebHostBuilder hostBuilder, Type startupType);
public static IWebHostBuilder UseStartup<TStartup>(this IWebHostBuilder hostBuilder) where TStartup : class;

ASP.NET Core 项目模板使用的是第二个重载，即泛型版本。泛型版本内部实际上调用的是非泛型版本。如果 Startup 不是定义在 ASP.NET Core Web 项目而是另一个程序集中，可先通过反射获取 Startup 的类型，然后调用非泛型版本。当然，通过反射来调用泛型版本也是可以的，但想不出这样做的理由。

Startup 会被注册为单例，多次调用 UseStartup 只有最后一个有效。
应用名称默认是 Startup 类所在程序集的名称，如果将 Startup 类放在另一个程序集中，需要留意这一点。

如果不使用 Startup 类，不注册服务，只配置中间件的话，可以使用 IWebHostBuilder.Configure 扩展方法：

1	public static IWebHostBuilder Configure(this IWebHostBuilder hostBuilder, Action<IApplicationBuilder> configureApp);

Configure 看似是添加中间件的方法，其实不然。

四、使用第三方依赖注入

在 Startup 中替换依赖注入容器，以 Autofac 为例。第一种是实现 ConfigureContainer 方法：

// ConfigureContainer is where you can register things directly
// with Autofac. This runs after ConfigureServices so the things
// here will override registrations made in ConfigureServices.
// Don't build the container; that gets done for you. If you
// need a reference to the container, you need to use the
// "Without ConfigureContainer" mechanism shown later.
public void ConfigureContainer(ContainerBuilder builder)
{
    builder.RegisterModule(new AutofacModule());
}

第二种是实现 ConfigureServices 方法：

// ConfigureServices is where you register dependencies. This gets
// called by the runtime before the Configure method, below.
public IServiceProvider ConfigureServices(IServiceCollection services)
{
    // Add services to the collection.
    services.AddMvc();
    // Create the container builder.
    var builder = new ContainerBuilder();
    // Register dependencies, populate the services from
    // the collection, and build the container.
    //
    // Note that Populate is basically a foreach to add things
    // into Autofac that are in the collection. If you register
    // things in Autofac BEFORE Populate then the stuff in the
    // ServiceCollection can override those things; if you register
    // AFTER Populate those registrations can override things
    // in the ServiceCollection. Mix and match as needed.
    builder.Populate(services);
    builder.RegisterType<MyType>().As<IMyType>();
    this.ApplicationContainer = builder.Build();
    // Create the IServiceProvider based on the container.
    return new AutofacServiceProvider(this.ApplicationContainer);
}

第三种方法是采用自定义 IServiceProviderFactory 的方式，比如 Abp：

public static class AbpAutofacAbpApplicationCreationOptionsExtensions
{
 public static void UseAutofac(this AbpApplicationCreationOptions options)
 {
   ContainerBuilder builder = new ContainerBuilder();
   options.Services.AddObjectAccessor<ContainerBuilder>(builder);
   options.Services.AddSingleton<IServiceProviderFactory<ContainerBuilder>>((IServiceProviderFactory<ContainerBuilder>) new AbpAutofacServiceProviderFactory(builder));
 }
}

对于第三种方法，不用陷入先有鸡还是先有蛋的困境，WebHostBuilder 的 Build 方法会创建一个 HostingServiceProvider 。

五、服务注册点

包含名为 ConfigureServices 或类似的方法的接口和类：

类/接口	程序集	命名空间	备注
IStartup	Microsoft.AspNetCore.Hosting.Abstractions	Microsoft.AspNetCore.Hosting	接口。实现类定义于应用。配合 IWebHostBuilder.UseStartup 方法。
Startup	自定义	自定义	定义于应用。不继承任何接口或类，实现 Configure 和 ConfigureServices 等方法。配合 IWebHostBuilder.UseStartup 方法。
IWebHostBuilder	Microsoft.AspNetCore.Hosting.Abstractions	Microsoft.AspNetCore.Hosting	接口。
WebHostBuilder : IWebHostBuilder	Microsoft.AspNetCore.Hosting	Microsoft.AspNetCore.Hosting	ConfigureServices 不会进行实际的服务注册操作，当调用 Build 方法时才注册。

六、中间件注册点

包含名为 Configure 或类似方法的接口和类：

类/接口	程序集	命名空间	备注
IStartup	Microsoft.AspNetCore.Hosting.Abstractions	Microsoft.AspNetCore.Hosting	接口。实现类定义于应用。配合 IWebHostBuilder.UseStartup 方法。
IHostingStartup	Microsoft.AspNetCore.Hosting.Abstractions	Microsoft.AspNetCore.Hosting	接口。
Startup	自定义	自定义	定义于应用。不继承任何接口或类，实现 Configure 和 ConfigureServices 等方法。配合 IWebHostBuilder.UseStartup 方法。
IStartupFilter	Microsoft.AspNetCore.Hosting.Abstractions	Microsoft.AspNetCore.Hosting	接口。实现类定义于应用。需注册为服务。

Alby's blog