Host.CreateDefaultBuilder Method

Definition

Namespace:

Microsoft.Extensions.Hosting

Assembly:

Microsoft.Extensions.Hosting.dll

Package:

Microsoft.Extensions.Hosting v9.0.0

Overloads

CreateDefaultBuilder()	Initializes a new instance of the HostBuilder class with pre-configured defaults.
CreateDefaultBuilder(String[])	Initializes a new instance of the HostBuilder class with pre-configured defaults.

CreateDefaultBuilder()

Source:

Host.cs

Initializes a new instance of the HostBuilder class with pre-configured defaults.

public:
 static Microsoft::Extensions::Hosting::IHostBuilder ^ CreateDefaultBuilder();

public static Microsoft.Extensions.Hosting.IHostBuilder CreateDefaultBuilder ();

static member CreateDefaultBuilder : unit -> Microsoft.Extensions.Hosting.IHostBuilder

Public Shared Function CreateDefaultBuilder () As IHostBuilder

Returns

IHostBuilder

The initialized IHostBuilder.

Remarks

The following defaults are applied to the returned HostBuilder:

• set the ContentRootPath to the result of GetCurrentDirectory()
• load host IConfiguration from "DOTNET_" prefixed environment variables
• load app IConfiguration from 'appsettings.json' and 'appsettings.[EnvironmentName].json'
• load app IConfiguration from User Secrets when EnvironmentName is 'Development' using the entry assembly
• load app IConfiguration from environment variables
• configure the ILoggerFactory to log to the console, debug, and event source output
• enables scope validation on the dependency injection container when EnvironmentName is 'Development'

CreateDefaultBuilder(String[])

Source:

Host.cs

Initializes a new instance of the HostBuilder class with pre-configured defaults.

public:
 static Microsoft::Extensions::Hosting::IHostBuilder ^ CreateDefaultBuilder(cli::array <System::String ^> ^ args);

public static Microsoft.Extensions.Hosting.IHostBuilder CreateDefaultBuilder (string[]? args);

static member CreateDefaultBuilder : string[] -> Microsoft.Extensions.Hosting.IHostBuilder

Public Shared Function CreateDefaultBuilder (args As String()) As IHostBuilder

Parameters

args

String[]

The command line args.

Returns

IHostBuilder

The initialized IHostBuilder.

Remarks

The following defaults are applied to the returned HostBuilder:

• set the ContentRootPath to the result of GetCurrentDirectory()
• load host IConfiguration from "DOTNET_" prefixed environment variables
• load host IConfiguration from supplied command line args
• load app IConfiguration from 'appsettings.json' and 'appsettings.[EnvironmentName].json'
• load app IConfiguration from User Secrets when EnvironmentName is 'Development' using the entry assembly
• load app IConfiguration from environment variables
• load app IConfiguration from supplied command line args
• configure the ILoggerFactory to log to the console, debug, and event source output
• enables scope validation on the dependency injection container when EnvironmentName is 'Development'