MediatR 14.0.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.Autofac.DependencyInjection
An extension for Autofac-IoC to use MediatR and CQRS with ease.
|
8 |
|
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
|
8 |
|
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
|
9 |
|
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
|
10 |
|
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
|
11 |
|
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
|
15 |
.NET Framework 4.6.2
- MediatR.Contracts (>= 2.0.1 && < 3.0.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.0)
- Microsoft.IdentityModel.JsonWebTokens (>= 8.14.0)
.NET 8.0
- MediatR.Contracts (>= 2.0.1 && < 3.0.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.0)
- Microsoft.IdentityModel.JsonWebTokens (>= 8.14.0)
.NET 9.0
- MediatR.Contracts (>= 2.0.1 && < 3.0.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.0)
- Microsoft.IdentityModel.JsonWebTokens (>= 8.14.0)
.NET 10.0
- MediatR.Contracts (>= 2.0.1 && < 3.0.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.0)
- Microsoft.IdentityModel.JsonWebTokens (>= 8.14.0)
.NET Standard 2.0
- MediatR.Contracts (>= 2.0.1 && < 3.0.0)
- Microsoft.Bcl.AsyncInterfaces (>= 10.0.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.0)
- Microsoft.IdentityModel.JsonWebTokens (>= 8.14.0)
| Version | Downloads | Last updated |
|---|---|---|
| 14.0.0 | 1 | 16.12.2025 |
| 14.0.0-beta-1 | 2 | 01.12.2025 |
| 13.1.0 | 1 | 09.11.2025 |
| 13.0.0 | 7 | 09.07.2025 |
| 12.5.0 | 8 | 23.05.2025 |
| 12.4.1 | 17 | 02.12.2024 |
| 12.4.0 | 13 | 02.12.2024 |
| 12.3.0 | 12 | 23.01.2025 |
| 12.2.0 | 13 | 23.01.2025 |
| 12.1.1 | 10 | 27.01.2025 |
| 12.0.1 | 14 | 28.01.2025 |
| 11.1.0 | 15 | 23.01.2025 |
| 11.0.0 | 18 | 02.12.2024 |
| 10.0.1 | 12 | 27.01.2025 |
| 10.0.0 | 13 | 23.01.2025 |
| 9.0.0 | 11 | 28.01.2025 |
| 8.1.0 | 11 | 24.01.2025 |
| 8.0.2 | 12 | 27.01.2025 |
| 8.0.1 | 11 | 27.02.2025 |
| 8.0.0 | 11 | 27.01.2025 |
| 7.0.0 | 13 | 23.01.2025 |
| 6.0.0 | 13 | 23.01.2025 |
| 5.1.0 | 13 | 23.01.2025 |
| 5.0.1 | 11 | 28.01.2025 |
| 5.0.1-alpha-0002 | 12 | 27.01.2025 |
| 5.0.1-alpha-0001 | 11 | 09.03.2025 |
| 4.1.0 | 12 | 28.01.2025 |
| 4.0.1 | 13 | 28.01.2025 |
| 4.0.0 | 11 | 24.01.2025 |
| 4.0.0-alpha-0002 | 12 | 28.01.2025 |
| 4.0.0-alpha | 11 | 23.01.2025 |
| 3.0.1 | 12 | 28.01.2025 |
| 3.0.0 | 14 | 23.01.2025 |
| 2.1.0 | 12 | 28.01.2025 |
| 2.1.0-beta-19 | 11 | 23.01.2025 |
| 2.0.2 | 12 | 28.01.2025 |
| 2.0.1 | 12 | 27.01.2025 |
| 2.0.0 | 11 | 28.01.2025 |
| 2.0.0-beta-005 | 12 | 23.01.2025 |
| 2.0.0-beta-004 | 11 | 23.01.2025 |
| 2.0.0-beta-003 | 11 | 24.01.2025 |
| 2.0.0-beta-002 | 11 | 23.01.2025 |
| 2.0.0-beta-001 | 10 | 27.01.2025 |
| 1.0.0 | 12 | 27.01.2025 |
| 0.5.0 | 11 | 28.01.2025 |
| 0.4.0 | 13 | 23.01.2025 |
| 0.3.0 | 10 | 23.01.2025 |
| 0.2.0 | 11 | 27.01.2025 |
| 0.1.0 | 13 | 28.01.2025 |