NuGet Package NServiceBus.Extensions.Hosting (1.x)
Target NServiceBus Version: 7.x
Not compatible with Microsoft.Extensions.Logging, use community package NServiceBus.MicrosoftLogging.Hosting as shown in .NET Core Generic Host sample.


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.

UseNServiceBus must be specified before any other service (e.g. ConfigureWebHostDefaults) which requires access to the IMessageSession.

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.


Last modified