Microsoft.Extensions.Hosting

Specifies a behavior that the will honor if an unhandled exception occurs in one of its instances.

Stops the instance.

If a throws an exception, the instance stops, and the process continues.

Ignore exceptions thrown in .

If a throws an exception, the will log the error, but otherwise ignore it. The is not restarted.

Provides option flags for .

Gets or sets a value that indicates if host lifetime status messages should be suppressed, such as on startup.

if host lifetime status messages should be suppressed. The default is .

Provides convenience methods for creating instances of with pre-configured defaults.

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

The following defaults are applied to the returned : set the to the result of load host from "DOTNET_" prefixed environment variables load app from 'appsettings.json' and 'appsettings.[].json' load app from User Secrets when is 'Development' using the entry assembly load app from environment variables configure the to log to the console, debug, and event source output enables scope validation on the dependency injection container when is 'Development' The initialized .

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

The following defaults are applied to the returned : set the to the result of load host from "DOTNET_" prefixed environment variables load host from supplied command line args load app from 'appsettings.json' and 'appsettings.[].json' load app from User Secrets when is 'Development' using the entry assembly load app from environment variables load app from supplied command line args configure the to log to the console, debug, and event source output enables scope validation on the dependency injection container when is 'Development' The command line args. The initialized .

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

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

Controls the initial configuration and other settings for constructing the . The initialized .

Represents a hosted applications and services builder that helps manage configuration, logging, lifetime, and more.

Initializes a new instance of the class with preconfigured defaults.

The following defaults are applied to the returned : set the to the result of load host from "DOTNET_" prefixed environment variables load host from supplied command line args load app from 'appsettings.json' and 'appsettings.[].json' load app from '[].settings.json' and '[].settings.[].json' when is not empty load app from User Secrets when is 'Development' using the entry assembly load app from environment variables load app from supplied command line args configure the to log to the console, debug, and event source output enables scope validation on the dependency injection container when is 'Development'

Initializes a new instance of the class with preconfigured defaults.

The following defaults are applied to the returned : set the to the result of load host from "DOTNET_" prefixed environment variables load host from supplied command line args load app from 'appsettings.json' and 'appsettings.[].json' load app from '[].settings.json' and '[].settings.[].json' when is not empty load app from User Secrets when is 'Development' using the entry assembly load app from environment variables load app from supplied command line args configure the to log to the console, debug, and event source output enables scope validation on the dependency injection container when is 'Development' The command line args.

Initializes a new instance of the .

Settings controlling initial configuration and whether default settings should be used.

Gets the set of key/value configuration properties.

This can be mutated by adding more configuration sources, which will update its current view.

Builds the host. This method can only be called once.

An initialized .

Settings for constructing an .

Initializes an instance of the class.

Gets or sets a value that indicates whether the instance is configured with pre-configured defaults.

if the instance is configured with pre-configured defaults. This has a similar effect to calling . The following defaults are applied to the : * set the to the result of * load from "DOTNET_" prefixed environment variables * load from 'appsettings.json' and 'appsettings.[].json' * load from User Secrets when is 'Development' using the entry assembly * load from environment variables * load from supplied command line args * configure the to log to the console, debug, and event source output * enables scope validation on the dependency injection container when is 'Development'

Gets or sets the command-line arguments to add to the .

Gets or sets the initial configuration sources to be added to the . These sources can influence the through the use of keys. Disposing the built disposes the .

Gets or sets the environment name.

Gets or sets the application name.

Gets or sets the content root path.

A program initialization utility.

Initializes a new instance of .

Gets a central location for sharing state between components during the host building process.

Set up the configuration for the builder itself. This will be used to initialize the for use later in the build process. This can be called multiple times and the results will be additive.

The delegate for configuring the that will be used to construct the for the host. The same instance of the for chaining.

Sets up the configuration for the remainder of the build process and application. This can be called multiple times and the results will be additive. The results will be available at for subsequent operations, as well as in .

The delegate for configuring the that will be used to construct the for the host. The same instance of the for chaining.

Adds services to the container. This can be called multiple times and the results will be additive.

The delegate for configuring the that will be used to construct the for the host. The same instance of the for chaining.

Overrides the factory used to create the service provider.

The type of the builder to create. A factory used for creating service providers. The same instance of the for chaining.

Overrides the factory used to create the service provider.

A factory used for creating service providers. The type of the builder to create. The same instance of the for chaining.

Enables configuring the instantiated dependency container. This can be called multiple times and the results will be additive.

The type of the builder to create. The delegate for configuring the that will be used to construct the for the host. The same instance of the for chaining.

Run the given actions to initialize the host. This can only be called once.

An initialized . Adds basic services to the host such as application lifetime, host environment, and logging.

Provides extension methods for the from the hosting package.

Specifies the environment to be used by the host. To avoid the environment being overwritten by a default value, ensure this is called after defaults are configured.

The to configure. The environment to host the application in. The .

Specifies the content root directory to be used by the host. To avoid the content root directory being overwritten by a default value, ensure this is called after defaults are configured.

The to configure. Path to root directory of the application. The .

Specifies the to be the default one.

The to configure. The delegate that configures the . The .

Specifies the to be the default one.

The to configure. The delegate that configures the . The .

Adds a delegate for configuring the provided . This can be called multiple times.

The to configure. The delegate that configures the . The same instance of the for chaining.

Adds a delegate for configuring the provided . This can be called multiple times.

The to configure. The delegate that configures the . The same instance of the for chaining.

Adds a delegate for configuring the of the .

The to configure. The delegate for configuring the . The same instance of the for chaining.

Adds a delegate for configuring the of the .

The to configure. The delegate for configuring the . The same instance of the for chaining.

The to configure. The delegate for configuring the that will be used to construct the for the host. The same instance of the for chaining.

Adds services to the container. This can be called multiple times and the results will be additive.

The to configure. The delegate for configuring the . The same instance of the for chaining.

Enables configuring the instantiated dependency container. This can be called multiple times and the results will be additive.

The type of builder. The to configure. The delegate for configuring the . The same instance of the for chaining.

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

The following defaults are applied to the : * set the to the result of * load host from "DOTNET_" prefixed environment variables * load host from supplied command line args * load app from 'appsettings.json' and 'appsettings.[].json' * load app from '[].settings.json' and '[].settings.[].json' when is not empty * load app from User Secrets when is 'Development' using the entry assembly * load app from environment variables * load app from supplied command line args * configure the to log to the console, debug, and event source output * enables scope validation on the dependency injection container when is 'Development' The existing builder to configure. The command line args. The same instance of the for chaining.

Listens for Ctrl+C or SIGTERM and calls to start the shutdown process. This will unblock extensions like RunAsync and WaitForShutdownAsync.

The to configure. The same instance of the for chaining.

Listens for Ctrl+C or SIGTERM and calls to start the shutdown process. This will unblock extensions like RunAsync and WaitForShutdownAsync.

The to configure. The delegate for configuring the . The same instance of the for chaining.

Enables console support, builds and starts the host, and waits for Ctrl+C or SIGTERM to shut down.

The to configure. A that can be used to cancel the console. A that only completes when the token is triggered or shutdown is triggered.

Enables console support, builds and starts the host, and waits for Ctrl+C or SIGTERM to shut down.

The to configure. The delegate for configuring the . A that can be used to cancel the console. A that only completes when the token is triggered or shutdown is triggered.

Adds a delegate for configuring the provided . This can be called multiple times.

The to configure. The delegate that configures the . The same instance of the for chaining.

Adds a delegate for configuring the provided . This can be called multiple times.

The to configure. The delegate that configures the . The same instance of the for chaining.

Options for .

Gets or sets the default timeout for .

This timeout also encompasses all host services implementing and .

Gets or sets the default timeout for .

This timeout also encompasses all host services implementing and .

Gets or sets a value that indicates if the will start registered instances of concurrently or sequentially.

if the will start registered instances of concurrently; if the will start registered instances sequentially. The default is .

Gets or sets a value that indicates if the will stop registered instances of concurrently or sequentially.

if the will stop registered instances of concurrently; if the will stop registered instances sequentially. The default is .

Gets or sets the behavior the will follow when any of its instances throw an unhandled exception.

Defaults to .

Allows consumers to perform cleanup during a graceful shutdown.

Initializes an instance using the specified logger.

The logger to initialize this instance with.

Gets a cancellation token. Triggered when the application host has fully started and is about to wait for a graceful shutdown.

Gets a cancellation token. Triggered when the application host is performing a graceful shutdown. Request might still be in flight. Shutdown will block until this event completes.

Gets a cancellation token. Triggered when the application host is performing a graceful shutdown. All requests should be complete at this point. Shutdown will block until this event completes.

Signals the ApplicationStopping event and blocks until it completes.

Signals the ApplicationStarted event and blocks until it completes.

Signals the ApplicationStopped event and blocks until it completes.

Listens for Ctrl+C or SIGTERM and initiates shutdown.

Initializes a instance using the specified console lifetime options, host environment, host application lifetime, and host options.

An object used to retrieve instances. Information about the hosting environment an application is running in. An object that allows consumers to be notified of application lifetime events. An object used to retrieve internal host options instances. or or or is .

Initializes a instance using the specified console lifetime options, host environment, host options, and logger factory.

Registers the application start, application stop and shutdown handlers for this application.

The cancellation token to monitor for cancellation requests. A that represents the asynchronous registration operation.

This method does nothing.

A cancellation token instance. A that represents a completed task.

Unregisters the shutdown handlers and disposes the application start and application stop registrations.

Order: IHostLifetime.WaitForStartAsync Services.GetService{IStartupValidator}().Validate() IHostedLifecycleService.StartingAsync IHostedService.Start IHostedLifecycleService.StartedAsync IHostApplicationLifetime.ApplicationStarted

Order: IHostedLifecycleService.StoppingAsync IHostApplicationLifetime.ApplicationStopping IHostedService.Stop IHostedLifecycleService.StoppedAsync IHostApplicationLifetime.ApplicationStopped IHostLifetime.StopAsync

This API supports infrastructure and is not intended to be used directly from your code. This API may change or be removed in future releases.

Minimalistic lifetime that does nothing.

The application name changed from "{0}" to "{1}". Changing host configuration is not supported.

The HostOptions.BackgroundServiceExceptionBehavior is configured to StopHost. A BackgroundService has thrown an unhandled exception, and the IHost instance is stopping. To avoid this behavior, configure this to Ignore; however the BackgroundService will no ...

Build can only be called once.

The content root changed from "{0}" to "{1}". Changing host configuration is not supported.

CreateBuilder must be called before CreateServiceProvider

The environment name changed from "{0}" to "{1}". Changing host configuration is not supported.

Replacing IHostApplicationLifetime is not supported.

The IServiceProviderFactory returned a null IServiceProvider

The resolver returned a null IServiceProviderFactory