Skip to main content

Migration Guides

Dispatch provides migration paths from popular .NET messaging libraries. Each guide covers the key differences, mapping tables, and step-by-step instructions to help you transition smoothly.

Before You Start​

  • .NET 8.0+ (or .NET 9/10 for latest features)
  • Install the required packages: 
    dotnet add package Excalibur.Dispatch
    dotnet add package Excalibur.Dispatch.Abstractions
  • Familiarity with Getting Started and Core Concepts

Available Migration Guides​

  • From MediatR -- Migrate request/response and notification patterns to Dispatch actions and events.
  • From MassTransit -- Migrate consumers, sagas, and transport configuration to Dispatch equivalents.
  • From NServiceBus -- Migrate handlers, sagas, and pipeline behaviors to the Dispatch model.
  • From ASP.NET Eventing Proposal -- Migrate from the ASP.NET eventing proposal pattern.

Reference​

  • Version Upgrades -- Versioning policy and current registration API reference.
  • MessageContext Guide -- Using IMessageContext direct properties for type-safe, high-performance message context access.

See Also​