AI agents: use the documentation index at llms.txt to locate machine-readable pages. This section is indexed by https://docs.particular.net/nservicebus/llms.txt. The markdown version of this page is served as plain text. An MCP server at /mcp serves the same content via the search_docs and read_doc tools; it is read-only and needs no credentials. Markdown versions of documentation pages are available by appending .md to the page URL. Directory URLs use index.md. They are served as text/plain because some retrieval backends reject text/markdown.

Azure Functions (in-process) for Service Bus Upgrade Version 1 to 2

This version relies on NServiceBus.Transport.AzureServiceBus Version 2 which uses the new Azure.Messaging.ServiceBus SDK from Microsoft. See the transport upgrade guide for more details.

Registering NServiceBus

All public constructors of ServiceBusTriggeredEndpointConfiguration have been made internal.

Instead of

functionsHostBuilder.UseNServiceBus(() => new ServiceBusTriggeredEndpointConfiguration(endpointName));

use:

functionsHostBuilder.UseNServiceBus(endpointName);

The endpoint name can be inferred from NServiceBusTriggerFunctionAttribute if present.

[assembly: NServiceBusTriggerFunction("MyEndpoint")]

// ...

functionsHostBuilder.UseNServiceBus(); // Will use the name MyEndpoint

Routing

Instead of

functionsHostBuilder.UseNServiceBus(() =>
{
    var serviceBusTriggeredEndpointConfiguration = new ServiceBusTriggeredEndpointConfiguration(endpointName);
    var routing = serviceBusTriggeredEndpointConfiguration.Transport.Routing();
    routing.RouteToEndpoint(typeof(SomeMessage), "AnotherEndpoint");

    return serviceBusTriggeredEndpointConfiguration;
});

use:

functionsHostBuilder.UseNServiceBus(endpointName, nsb =>
{
    nsb.Routing.RouteToEndpoint(typeof(SomeMessage), "AnotherEndpoint");
});

Static hosting model has been deprecated

The ServiceBusTriggeredEndpointConfiguration.FromAttributes() static factory method that was used in the preview package has been deprecated. Instead, use the host builder configuration model.

In this article