public class Program
{
    public static void Main(string[] args)
    {
        CreateWebHostBuilder(args).Build().Run();
    }

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

代码中调用 CreateDefaultBuilder 的是在一个叫做 CreateWebHostBuilder 的方法中，这个方法从 Main 中分离出来，在 Main 方法中在 builder 对象上调用 Run 方法。这中分离是有必须的，如果你使用了 Entity Framework Core tools。这个工具期望找到一个 CreateWebHostBuilder 方法，以便能不必运行应用程序就能够在设计的时候配置 Host。一种途径是实现接口 IDesignTimeDbContextFactory。更多信息，查看 Design-time DbContext Creation。

CreateDefaultBuilder 执行了以下任务：

• 使用应用程序的托管配置的应用程序提供器配置 Kestrel 服务器作为 web 服务器。Kestrel 服务器默认选项，查看 Configure options for the ASP.NET Core Kestrel web server。
• 设置 content root 为 Directory.GetCurrentDirectory 返回的路径值
• 从以下地方加载主机配置（host configuration）
  前缀为 ASPNETCORE_  的环境变量（例如，ASPNETCORE_ENVIRONMENT）
  命令行参数
• 按照下面的顺序加载应用程序配置
  appsetting.json
  appsetting.{Environment}.json
  User secrets 当应用程序使用入口程序集运行在 Development 环境时
  环境变量
  命令行参数
• 为控制台和调试输出配置日志（logging）。日志包括在 appsetting.json 或者 appsetting.{Environment}.json 文件中配置区域配置的日志过滤（log filtering）规则。
• 当 ASP.NET Core Module 运行在 IIS 之后，CreateDefaultBuilder 会使能 IIS 集成（IIS Integration），配置了应用程序基本地址和端口。IIS 集成也会配置应用程序捕获启动错误（capture startup errors）。关于 IIS 默认配置，查看 Host ASP.NET Core on Windows with IIS。
• 如果应用程序环境为 Development，设置 ServiceProviderOptions.ValidateScopes 为 true。更多信息，查看 Scope validation。
  
  

CreateDefaultBuilder 定义的配置可以被覆盖和使用 ConfigureAppConfiguration，ConfigureLogging 和其它方法及 IWebHostBuilder 的扩展方法扩展。下面是几个例子：

• ConfigureAppConfiguration 用来为应用程序指定额外的 IConfiguration。下面的 ConfigureAppConfiguration 调用添加了一个代理去包含在 appsettings.xml 文件中的应用程序的配置。ConfigureAppConfiguration 可能会调用多次。注意这个配置并不应用到主机（例如，服务器 URLs 或者 环境）。查看 Host configuration values 部分。
  

  WebHost.CreateDefaultBuilder(args)
      .ConfigureAppConfiguration((hostingContext, config) =>
      {
          config.AddXmlFile("appsettings.xml", optional: true, reloadOnChange: true);
      })
      ...

• 下面的 ConfigureLogging 调用添加一个代理去配置最小的logging level (SetMinimumLevel) 为 LogLevel.Warning。这个设置覆盖了appsettings.Development.json (LogLevel.Debug) 和 appsettings.Production.json (LogLevel.Error) 里面通过 CreateDefaultBuilder 配置的设置。ConfigureLogging 可能会调用多次。
  

  WebHost.CreateDefaultBuilder(args)
      .ConfigureLogging(logging => 
      {
          logging.SetMinimumLevel(LogLevel.Warning);
      })
      ...

• 下面的 ConfigureKestrel 的调用覆盖了 Kestrel 通过 CreateDefaultBuilder 配置的默认的 Limits.MaxRequestBodySize 30，000，000 字节：
  

  WebHost.CreateDefaultBuilder(args)
      .ConfigureKestrel((context, options) =>
      {
          options.Limits.MaxRequestBodySize = 20000000;
      });

  content root 决定了 Host 在哪里搜索内容文件，例如 MVC 视图文件。当应用程序从工程根目录启动的时候，工程根目录被用作内容根目录。这在 Visual Studio 和 dotnet new templates 默认使用。

更多关于应用程序配置的信息，查看 Configuration in ASP.NET Core。

注意

作为一种使用静态 CreateDefaultBuilder 方法的途径，从 WebHostBuilder 创建一个 Host 在 ASP.NET Core 2.x 中是受支持的。

当设置一个主机的时候，可以提供 Configure 和 ConfigureServices 这两个方法。如果一个 Startup 方法被指定了，它必须定义 Configure 方法。更多信息，查看 App startup in ASP.NET Core 。多次调用 ConfigureServices 将会附加到另外一个上面。在 WebHostBuilder 上多次调用 Configure 或者 UseStartup 将会替换之前的设置。

Host configuration values

WebHostBuilder 依赖下面的方法设置主机配置值：

• Host builder configuration，包含格式为 ASPNETCORE_{configurationKey} 的环境变量。例如，ASPNETCORE_ENVIRONMENT。
• 扩展，例如 UseContentRoot 和 UseConfiguration （查看 Override configuration 部分）
• UseSetting 和相关的键。当使用 UseSetting 设置值得时候，值被设置为字符串而忽略它的类型。

主机使用最后设置值得选项。更多信息查看，Override configuration。

Application Key (Name)

当 UseStartup 或者 Configure 在主机构造方法中调用的时候，IWebHostEnvironment.ApplicationName 属性会自动设置。值被设置为包含应用程序入口点的程序集的名称。显式的设置，可以使用 WebHostDefaults.ApplicationKey：

Key: applicationName

Type: string

Default: 包含应用程序入口点程序集的名称

Set using: UseSetting

Environment variable: ASPNETCORE_APPLICATIONNAME

WebHost.CreateDefaultBuilder(args)
    .UseSetting(WebHostDefaults.ApplicationKey, "CustomApplicationName")

WebHost.CreateDefaultBuilder(args)
    .CaptureStartupErrors(true)

WebHost.CreateDefaultBuilder(args)
    .UseContentRoot("c:\\<content-root>")

WebHost.CreateDefaultBuilder(args)
    .UseSetting(WebHostDefaults.DetailedErrorsKey, "true")

WebHost.CreateDefaultBuilder(args)
    .UseEnvironment(EnvironmentName.Development)

WebHost.CreateDefaultBuilder(args)
    .UseSetting(WebHostDefaults.HostingStartupAssembliesKey, "assembly1;assembly2")

WebHost.CreateDefaultBuilder(args)
    .UseSetting("https_port", "8080")

WebHost.CreateDefaultBuilder(args)
    .UseSetting(WebHostDefaults.HostingStartupExcludeAssembliesKey, "assembly1;assembly2")

WebHost.CreateDefaultBuilder(args)
    .PreferHostingUrls(false)

WebHost.CreateDefaultBuilder(args)
    .UseSetting(WebHostDefaults.PreventHostingStartupKey, "true")

WebHost.CreateDefaultBuilder(args)
    .UseUrls("http://*:5000;http://localhost:5001;https://hostname:5002")

WebHost.CreateDefaultBuilder(args)
    .UseShutdownTimeout(TimeSpan.FromSeconds(10))

WebHost.CreateDefaultBuilder(args)
    .UseStartup("StartupAssemblyName")

WebHost.CreateDefaultBuilder(args)
    .UseStartup<TStartup>()

WebHost.CreateDefaultBuilder(args)
    .UseWebRoot("public")

public class Program
{
    public static void Main(string[] args)
    {
        CreateWebHostBuilder(args).Build().Run();
    }

    public static IWebHostBuilder CreateWebHostBuilder(string[] args)
    {
        var config = new ConfigurationBuilder()
            .SetBasePath(Directory.GetCurrentDirectory())
            .AddJsonFile("hostsettings.json", optional: true)
            .AddCommandLine(args)
            .Build();

        return WebHost.CreateDefaultBuilder(args)
            .UseUrls("http://*:5000")
            .UseConfiguration(config)
            .Configure(app =>
            {
                app.Run(context => 
                    context.Response.WriteAsync("Hello, World!"));
            });
    }
}

{
    urls: "http://*:5005"
}

dotnet run --urls "http://*:8080"

host.Run();

using (host)
{
    host.Start();
    Console.ReadLine();
}

var urls = new List<string>()
{
    "http://*:5000",
    "http://localhost:5001"
};

var host = new WebHostBuilder()
    .UseKestrel()
    .UseStartup<Startup>()
    .Start(urls.ToArray());

using (host)
{
    Console.ReadLine();
}

using (var host = WebHost.Start(app => app.Response.WriteAsync("Hello, World!")))
{
    Console.WriteLine("Use Ctrl-C to shutdown the host...");
    host.WaitForShutdown();
}

using (var host = WebHost.Start("http://localhost:8080", app => app.Response.WriteAsync("Hello, World!")))
{
    Console.WriteLine("Use Ctrl-C to shutdown the host...");
    host.WaitForShutdown();
}

using (var host = WebHost.Start(router => router
    .MapGet("hello/{name}", (req, res, data) => 
        res.WriteAsync($"Hello, {data.Values["name"]}!"))
    .MapGet("buenosdias/{name}", (req, res, data) => 
        res.WriteAsync($"Buenos dias, {data.Values["name"]}!"))
    .MapGet("throw/{message?}", (req, res, data) => 
        throw new Exception((string)data.Values["message"] ?? "Uh oh!"))
    .MapGet("{greeting}/{name}", (req, res, data) => 
        res.WriteAsync($"{data.Values["greeting"]}, {data.Values["name"]}!"))
    .MapGet("", (req, res, data) => res.WriteAsync("Hello, World!"))))
{
    Console.WriteLine("Use Ctrl-C to shutdown the host...");
    host.WaitForShutdown();
}

using (var host = WebHost.Start("http://localhost:8080", router => router
    .MapGet("hello/{name}", (req, res, data) => 
        res.WriteAsync($"Hello, {data.Values["name"]}!"))
    .MapGet("buenosdias/{name}", (req, res, data) => 
        res.WriteAsync($"Buenos dias, {data.Values["name"]}!"))
    .MapGet("throw/{message?}", (req, res, data) =>