Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions menu/menu.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -832,6 +832,8 @@
Title: Version 6 to 7
- Title: Azure Service Bus
Articles:
- Url: transports/upgrades/asbs-5to6
Title: Version 5 to 6
- Url: transports/upgrades/asbs-4to5
Title: Version 4 to 5
- Url: transports/upgrades/asbs-3to4
Expand Down
2 changes: 1 addition & 1 deletion transports/upgrades/asbs-1.7to1.8.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ upgradeGuideCoreVersions:

## Replacing shorteners with naming conventions

For existing shoteners, the logic has to be moved into appropriate naming conventions.
For existing shorteners, the logic has to be moved into appropriate naming conventions.
To retain the same behavior, a length check needs to be added to the naming conventions logic.

### RuleNameShortener
Expand Down
2 changes: 1 addition & 1 deletion transports/upgrades/asbs-1to2.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Azure Service Bus Transport Upgrade Version 1 to 2
summary: Migration instructions on how to upgrade the Azure Service Bus transport from version 1 to 2.
summary: Instructions on how to upgrade Azure Service Bus transport from version 1 to 2.
reviewed: 2022-03-25
component: ASBS
related:
Expand Down
2 changes: 1 addition & 1 deletion transports/upgrades/asbs-2to3.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Azure Service Bus Transport Upgrade Version 2 to 3
summary: Migration instructions on how to upgrade the Azure Service Bus transport from version 2 to 3
summary: Instructions on how to upgrade Azure Service Bus transport from version 2 to 3
reviewed: 2021-11-07
component: ASBS
related:
Expand Down
2 changes: 1 addition & 1 deletion transports/upgrades/asbs-3to4.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Azure Service Bus Transport Upgrade Version 3 to 4
summary: Migration instructions on how to upgrade the Azure Service Bus transport from version 3 to 4
summary: Instructions on how to upgrade Azure Service Bus transport from version 3 to 4
reviewed: 2023-12-12
component: ASBS
related:
Expand Down
6 changes: 4 additions & 2 deletions transports/upgrades/asbs-4to5.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,14 @@
---
title: Azure Service Bus Transport Upgrade Version 4 to 5
summary: Migration instructions on how to upgrade the Azure Service Bus transport from version 4 to 5
summary: Instructions on how to upgrade Azure Service Bus transport from version 4 to 5
reviewed: 2025-02-07
component: ASBS
related:
- transports/azure-service-bus
- samples/azure-service-bus-netstandard/topology-migration
isUpgradeGuide: true
upgradeGuideCoreVersions:
- 9
---

Upgrading Azure Service Bus transport from version 4 to version 5 is a major upgrade and requires careful planning. Read the entire upgrade guide before beginning the upgrade process.
Expand Down Expand Up @@ -226,7 +228,7 @@ static string HashName(string input)

### Migrating rule name customizations

Previously, rule names could be [assigned using function delegates](/transports/azure-service-bus/configuration.md?version=asbs_4#entity-creation-settings)
Previously, rule names could be [assigned using function delegates](/transports/azure-service-bus/configuration.md?version=asbs_4#entity-creation-settings)

```csharp
transport.SubscriptionRuleNamingConvention(x => "MyPrefix-"+x);
Expand Down
17 changes: 17 additions & 0 deletions transports/upgrades/asbs-5to6.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
---
title: Azure Service Bus Transport Upgrade Version 5 to 6
summary: Instructions on how to upgrade Azure Service Bus transport from version 5 to 6
reviewed: 2025-09-18
component: ASBS
related:
- transports/azure-service-bus
isUpgradeGuide: true
upgradeGuideCoreVersions:
- 9
- 10
---

## Transport Encoding Header

The `NServiceBus.Transport.Encoding` header is longer used, but the transport could still send it for compatibility with the legacy Azure Service Bus transport. The ability to send this header has been removed and the `SendTransportEncodingHeader` APIs to opt in to sending it have been deprecated.
Remove all references to these APIs.