Host.CreateApplicationBuilder Method

Definition

Namespace:

Microsoft.Extensions.Hosting

Assembly:

Microsoft.Extensions.Hosting.dll

Package:

Microsoft.Extensions.Hosting v9.0.0-preview.3.24172.9

Overloads

CreateApplicationBuilder()	Initializes a new instance of the HostApplicationBuilder class with preconfigured defaults.
CreateApplicationBuilder(HostApplicationBuilderSettings)	Initializes a new instance of the HostApplicationBuilder class with preconfigured defaults.
CreateApplicationBuilder(String[])	Initializes a new instance of the HostApplicationBuilder class with preconfigured defaults.

CreateApplicationBuilder()

Source:

Host.cs

Initializes a new instance of the HostApplicationBuilder class with preconfigured defaults.

public:
 static Microsoft::Extensions::Hosting::HostApplicationBuilder ^ CreateApplicationBuilder();

public static Microsoft.Extensions.Hosting.HostApplicationBuilder CreateApplicationBuilder ();

static member CreateApplicationBuilder : unit -> Microsoft.Extensions.Hosting.HostApplicationBuilder

Public Shared Function CreateApplicationBuilder () As HostApplicationBuilder

Returns

HostApplicationBuilder

A new HostApplicationBuilder instance.

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'.

CreateApplicationBuilder(HostApplicationBuilderSettings)

Source:

Host.cs

Initializes a new instance of the HostApplicationBuilder class with preconfigured defaults.

public:
 static Microsoft::Extensions::Hosting::HostApplicationBuilder ^ CreateApplicationBuilder(Microsoft::Extensions::Hosting::HostApplicationBuilderSettings ^ settings);

public static Microsoft.Extensions.Hosting.HostApplicationBuilder CreateApplicationBuilder (Microsoft.Extensions.Hosting.HostApplicationBuilderSettings? settings);

static member CreateApplicationBuilder : Microsoft.Extensions.Hosting.HostApplicationBuilderSettings -> Microsoft.Extensions.Hosting.HostApplicationBuilder

Public Shared Function CreateApplicationBuilder (settings As HostApplicationBuilderSettings) As HostApplicationBuilder

Parameters

settings

HostApplicationBuilderSettings

Controls the initial configuration and other settings for constructing the HostApplicationBuilder.

Returns

HostApplicationBuilder

A new HostApplicationBuilder instance.

CreateApplicationBuilder(String[])

Source:

Host.cs

Initializes a new instance of the HostApplicationBuilder class with preconfigured defaults.

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

public static Microsoft.Extensions.Hosting.HostApplicationBuilder CreateApplicationBuilder (string[]? args);

static member CreateApplicationBuilder : string[] -> Microsoft.Extensions.Hosting.HostApplicationBuilder

Public Shared Function CreateApplicationBuilder (args As String()) As HostApplicationBuilder

Parameters

args

String[]

The command line arguments.

Returns

HostApplicationBuilder

A new HostApplicationBuilder instance.

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'.