Host.CreateDefaultBuilder Method

Definition

Namespace:

Microsoft.Extensions.Hosting

Assembly:

Microsoft.Extensions.Hosting.dll

Package:

Microsoft.Extensions.Hosting v8.0.0

Overloads

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

CreateDefaultBuilder()

Source:

Host.cs

Initializes a new instance of the HostBuilder class with preconfigured 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.
• Enable 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 preconfigured 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 arguments.

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 arguments.
• 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 arguments.
• Configure the ILoggerFactory to log to the console, debug, and event source output.
• Enable scope validation on the dependency injection container when EnvironmentName is 'Development'.