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.

Upgrading message contracts from Version 7 to 8

Component: NServiceBus

This is part of the NServiceBus Upgrade Guide from Version 7 to 8, which also includes the following individual upgrade guides for specific components:

Feature Details
Transports
Persistence
Hosting
Other

NServiceBus version 8 does not support .NET Standard as a target framework. Therefore, message contract assemblies that target netstandard2.0 and reference NServiceBus must be updated. This guide shows possible approaches. General guidance is available in the sharing message contracts documentation.

Change to specific target Framework

If all endpoints share the same target framework (e.g., .NET Core 3.1), the message contracts assembly can be changed from targeting .NET Standard to the same target framework as the endpoint projects.

Multi-targeting

If endpoints sharing a common contracts assembly target different platforms and frameworks (e.g. both .NET Framework 4.8 and .NET Core 6.0), the target assembly can use multi-targeting by replacing the TargetFramwork element with the TargetFrameworks (note the plural) element in the .csproj settings:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <!-- Typically, it is sufficient to list the lowest version needed -->
    <TargetFrameworks>net48;net6.0</TargetFrameworks>
  </PropertyGroup>
</Project>

Get help

For further information and assistance, refer to the support channels.

In this article