HostingHostBuilderExtensions.ConfigureDefaults(IHostBuilder, String[]) Method

Reference

Definition

Namespace:: Microsoft.Extensions.Hosting

Assembly:: Microsoft.Extensions.Hosting.dll

Package:: Microsoft.Extensions.Hosting v9.0.2

Source:: HostingHostBuilderExtensions.cs

Source:: HostingHostBuilderExtensions.cs

Source:: HostingHostBuilderExtensions.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Configures an existing IHostBuilder instance with pre-configured defaults. This will overwrite previously configured values and is intended to be called before additional configuration calls.

public:
[System::Runtime::CompilerServices::Extension]
 static Microsoft::Extensions::Hosting::IHostBuilder ^ ConfigureDefaults(Microsoft::Extensions::Hosting::IHostBuilder ^ builder, cli::array <System::String ^> ^ args);

public static Microsoft.Extensions.Hosting.IHostBuilder ConfigureDefaults(this Microsoft.Extensions.Hosting.IHostBuilder builder, string[]? args);

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

<Extension()>
Public Function ConfigureDefaults (builder As IHostBuilder, args As String()) As IHostBuilder

Parameters

builder: IHostBuilder

The existing builder to configure.

args: String[]

The command line args.

Returns

IHostBuilder

The same instance of the IHostBuilder for chaining.

Remarks

The following defaults are applied to the IHostBuilder: * 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'

Applies to

Product	Versions
.NET	8 (package-provided), 9 (package-provided)
.NET Framework	4.7 (package-provided), 4.7.1 (package-provided), 4.7.2 (package-provided), 4.8 (package-provided)
.NET Standard	2.0 (package-provided), 2.1 (package-provided)

Share via