Host.CreateApplicationBuilder Method

Definition

Namespace:

Microsoft.Extensions.Hosting

Assembly:

Microsoft.Extensions.Hosting.dll

Package:

Microsoft.Extensions.Hosting v9.0.0-rc.2.24473.5

Overloads

CreateApplicationBuilder()	Initializes a new instance of the HostApplicationBuilder class with pre-configured 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 pre-configured defaults.

CreateApplicationBuilder()

Initializes a new instance of the HostApplicationBuilder class with pre-configured 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

The initialized HostApplicationBuilder.

Remarks

The following defaults are applied to the returned HostApplicationBuilder:

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

CreateApplicationBuilder(HostApplicationBuilderSettings)

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[])

Initializes a new instance of the HostApplicationBuilder class with pre-configured 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 args.

Returns

HostApplicationBuilder

The initialized HostApplicationBuilder.

Remarks

The following defaults are applied to the returned HostApplicationBuilder:

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