diff --git a/src/libraries/Microsoft.Extensions.Hosting/src/Host.cs b/src/libraries/Microsoft.Extensions.Hosting/src/Host.cs index 77d2d58801263..06c9a8fc8ba41 100644 --- a/src/libraries/Microsoft.Extensions.Hosting/src/Host.cs +++ b/src/libraries/Microsoft.Extensions.Hosting/src/Host.cs @@ -8,11 +8,49 @@ namespace Microsoft.Extensions.Hosting { + /// + /// Provides convenience methods for creating instances of with pre-configured defaults. + /// public static class Host { + /// + /// Initializes a new instance of the class with pre-configured defaults. + /// + /// + /// The following defaults are applied to the returned : + /// + /// set the to the result of + /// load host from "DOTNET_" prefixed environment variables + /// load app from 'appsettings.json' and 'appsettings.[].json' + /// load app from User Secrets when is 'Development' using the entry assembly + /// load app from environment variables + /// configure the to log to the console, debug, and event source output + /// enables scope validation on the dependency injecton container when is 'Development' + /// + /// + /// The initialized . public static IHostBuilder CreateDefaultBuilder() => CreateDefaultBuilder(args: null); + /// + /// Initializes a new instance of the class with pre-configured defaults. + /// + /// + /// The following defaults are applied to the returned : + /// + /// set the to the result of + /// load host from "DOTNET_" prefixed environment variables + /// load host from supplied command line args + /// load app from 'appsettings.json' and 'appsettings.[].json' + /// load app from User Secrets when is 'Development' using the entry assembly + /// load app from environment variables + /// load app from supplied command line args + /// configure the to log to the console, debug, and event source output + /// enables scope validation on the dependency injecton container when is 'Development' + /// + /// + /// The command line args. + /// The initialized . public static IHostBuilder CreateDefaultBuilder(string[] args) { var builder = new HostBuilder();