MediatR 13.1.0
MediatR
Simple mediator implementation in .NET
In-process messaging with no dependencies.
Supports request/response, commands, queries, notifications and events, synchronous and async with intelligent dispatching via C# generic variance.
Examples in the wiki.
Installing MediatR
You should install MediatR with NuGet:
Install-Package MediatR
Or via the .NET Core command line interface:
dotnet add package MediatR
Either commands, from Package Manager Console or .NET Core CLI, will download and install MediatR and all required dependencies.
Using Contracts-Only Package
To reference only the contracts for MediatR, which includes:
IRequest(including generic variants)INotificationIStreamRequest
Add a package reference to MediatR.Contracts
This package is useful in scenarios where your MediatR contracts are in a separate assembly/project from handlers. Example scenarios include:
- API contracts
- GRPC contracts
- Blazor
Registering with IServiceCollection
MediatR supports Microsoft.Extensions.DependencyInjection.Abstractions directly. To register various MediatR services and handlers:
services.AddMediatR(cfg => cfg.RegisterServicesFromAssemblyContaining<Startup>());
or with an assembly:
services.AddMediatR(cfg => cfg.RegisterServicesFromAssembly(typeof(Startup).Assembly));
This registers:
IMediatoras transientISenderas transientIPublisheras transientIRequestHandler<,>concrete implementations as transientIRequestHandler<>concrete implementations as transientINotificationHandler<>concrete implementations as transientIStreamRequestHandler<>concrete implementations as transientIRequestExceptionHandler<,,>concrete implementations as transientIRequestExceptionAction<,>)concrete implementations as transient
This also registers open generic implementations for:
INotificationHandler<>IRequestExceptionHandler<,,>IRequestExceptionAction<,>
To register behaviors, stream behaviors, pre/post processors:
services.AddMediatR(cfg => {
cfg.RegisterServicesFromAssembly(typeof(Startup).Assembly);
cfg.AddBehavior<PingPongBehavior>();
cfg.AddStreamBehavior<PingPongStreamBehavior>();
cfg.AddRequestPreProcessor<PingPreProcessor>();
cfg.AddRequestPostProcessor<PingPongPostProcessor>();
cfg.AddOpenBehavior(typeof(GenericBehavior<,>));
});
With additional methods for open generics and overloads for explicit service types.
Setting the license key
You can set the license key when registering MediatR:
services.AddMediatR(cfg =>
{
cfg.LicenseKey = "<license key here>";
})
Or if not using Microsoft.Extensions.DependencyInjection:
Mediator.LicenseKey = "<license key here>";
[!TIP] The license key does not need to be set on client applications (such as Blazor WASM). Turn off the license warning by configuring logging in your logging start configuration:
builder.Logging.AddFilter("LuckyPennySoftware.MediatR.License", LogLevel.None);
You can register for your license key at MediatR.io
Showing the top 20 packages that depend on MediatR.
| Packages | Downloads |
|---|---|
|
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
|
120 |
|
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
|
45 |
|
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
|
26 |
|
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
|
25 |
|
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
|
22 |
|
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
|
21 |
|
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
|
20 |
|
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
|
19 |
|
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
|
18 |
|
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
|
17 |
.NET Framework 4.6.2
- MediatR.Contracts (>= 2.0.1 && < 3.0.0)
- Microsoft.IdentityModel.JsonWebTokens (>= 8.14.0)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.0)
.NET Standard 2.0
- Microsoft.IdentityModel.JsonWebTokens (>= 8.14.0)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.0)
- Microsoft.Bcl.AsyncInterfaces (>= 8.0.0)
- MediatR.Contracts (>= 2.0.1 && < 3.0.0)
.NET 9.0
- Microsoft.IdentityModel.JsonWebTokens (>= 8.14.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.0)
- MediatR.Contracts (>= 2.0.1 && < 3.0.0)
.NET 8.0
- Microsoft.IdentityModel.JsonWebTokens (>= 8.14.0)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.0)
- MediatR.Contracts (>= 2.0.1 && < 3.0.0)
| Version | Downloads | Last updated |
|---|---|---|
| 13.1.0 | 3 | 10/30/2025 |
| 13.0.0 | 7 | 07/05/2025 |
| 12.5.0 | 13 | 04/13/2025 |
| 12.4.1 | 18 | 10/07/2024 |
| 12.4.0 | 20 | 07/25/2024 |
| 12.3.0 | 17 | 10/07/2024 |
| 12.2.0 | 17 | 10/07/2024 |
| 12.1.1 | 14 | 10/07/2024 |
| 12.0.1 | 20 | 03/18/2023 |
| 11.1.0 | 18 | 10/07/2024 |
| 11.0.0 | 15 | 10/07/2024 |
| 10.0.1 | 72 | 01/25/2022 |
| 10.0.0 | 19 | 10/07/2024 |
| 9.0.0 | 156 | 12/03/2021 |
| 8.1.0 | 18 | 05/17/2023 |
| 8.0.2 | 22 | 10/07/2024 |
| 8.0.1 | 17 | 10/07/2024 |
| 8.0.0 | 25 | 10/07/2024 |
| 7.0.0 | 16 | 10/07/2024 |
| 6.0.0 | 19 | 10/07/2024 |
| 5.1.0 | 21 | 10/07/2024 |
| 5.0.1 | 21 | 10/07/2024 |
| 5.0.1-alpha-0002 | 17 | 10/07/2024 |
| 5.0.1-alpha-0001 | 16 | 10/07/2024 |
| 4.1.0 | 21 | 10/07/2024 |
| 4.0.1 | 17 | 11/04/2024 |
| 4.0.0 | 19 | 10/20/2024 |
| 4.0.0-alpha-0002 | 15 | 10/07/2024 |
| 4.0.0-alpha | 15 | 10/07/2024 |
| 3.0.1 | 19 | 10/07/2024 |
| 3.0.0 | 16 | 10/07/2024 |
| 2.1.0 | 21 | 10/07/2024 |
| 2.1.0-beta-19 | 16 | 10/07/2024 |
| 2.0.2 | 13 | 10/07/2024 |
| 2.0.1 | 19 | 10/07/2024 |
| 2.0.0 | 15 | 10/07/2024 |
| 2.0.0-beta-005 | 18 | 10/07/2024 |
| 2.0.0-beta-004 | 15 | 10/07/2024 |
| 2.0.0-beta-003 | 16 | 10/07/2024 |
| 2.0.0-beta-002 | 13 | 10/07/2024 |
| 2.0.0-beta-001 | 15 | 10/07/2024 |
| 1.0.0 | 23 | 10/07/2024 |
| 0.5.0 | 16 | 10/07/2024 |
| 0.4.0 | 20 | 10/07/2024 |
| 0.3.0 | 20 | 10/07/2024 |
| 0.2.0 | 17 | 10/07/2024 |
| 0.1.0 | 22 | 10/07/2024 |