NuGet Package: NServiceBus.Extensions.Hosting (2-pre)
This page targets a pre-release version. Pre-releases are subject to change and samples are not guaranteed to be fully functional.


An NServiceBus endpoint can be hosted within the generic host with the UseNServiceBus extension method:

var host = Host.CreateDefaultBuilder()
    .UseNServiceBus(hostBuilderContext =>
        var endpointConfiguration = new EndpointConfiguration("MyEndpoint");
        // configure endpoint here
        return endpointConfiguration;

await host.RunAsync();

This code will register the endpoint with the hosting infrastructure and automatically start and stop it based on the host's application lifetime.

Specify UseNServiceBus before any other service (e.g. ConfigureWebHostDefaults) which requires access to the IMessageSession. Incorrect usage results in a System.InvalidOperationException with the following message:

The message session can't be used before NServiceBus is started. Place UseNServiceBus() on the host builder before registering any hosted service (e.g. services.AddHostedService<HostedServiceAccessingTheSession>()) or the web host configuration (e.g. builder.ConfigureWebHostDefaults) if hosted services or controllers require access to the session.

Logging integration

NServiceBus logging is automatically configured to use the logging configured for the generic host; no NServiceBus specific logging configuration is needed.

Dependency injection integration

NServiceBus endpoints hosted as part of the generic host automatically use the provided IServiceCollection and IServiceProvider dependency injection infrastructure. Message handlers can resolve dependencies which are registered in the IServiceCollection.

UseNServiceBus automatically registers an IMessageSession with the container which can be resolved from the IServiceProvider or via dependency injection during runtime.

Configure custom containers

Custom dependency injection containers may be configured using IWebHostBuilder.UseServiceProviderFactory. NServiceBus automatically uses the host's dependency injection container. Refer to the container's documentation for further details.

Shutdown timeout

The .NET Generic Host has a configurable shutdown timeout that defaults to five seconds. During this shutdown period, NServiceBus waits for all in-flight messages to complete. To ensure the shutdown timeout is honored, all message handlers must observe the cancellation token that is available on the message handler context.


Last modified