MediatR 13.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>";
})
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
|
26 |
|
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
|
27 |
|
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
|
28 |
|
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
|
29 |
|
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
|
30 |
|
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
|
33 |
|
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
|
34 |
.NET 8.0
- MediatR.Contracts (>= 2.0.1 && < 3.0.0)
- Microsoft.IdentityModel.JsonWebTokens (>= 8.0.1)
- Microsoft.Extensions.Logging (>= 8.0.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.0)
.NET Standard 2.0
- Microsoft.IdentityModel.JsonWebTokens (>= 8.0.1)
- Microsoft.Extensions.Logging (>= 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.0.1)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.0)
- MediatR.Contracts (>= 2.0.1 && < 3.0.0)
- Microsoft.Extensions.Logging (>= 8.0.0)
| Version | Downloads | Last updated |
|---|---|---|
| 13.0.0 | 1 | 07/18/2025 |
| 12.5.0 | 13 | 04/05/2025 |
| 12.4.1 | 19 | 09/13/2024 |
| 12.4.0 | 26 | 07/25/2024 |
| 12.3.0 | 18 | 06/23/2024 |
| 12.2.0 | 24 | 02/13/2024 |
| 12.1.1 | 32 | 02/13/2024 |
| 12.0.1 | 30 | 02/13/2024 |
| 11.1.0 | 26 | 02/13/2024 |
| 11.0.0 | 25 | 02/13/2024 |
| 10.0.1 | 31 | 03/22/2022 |
| 10.0.0 | 28 | 02/13/2024 |
| 9.0.0 | 24 | 02/13/2024 |
| 8.1.0 | 31 | 02/13/2024 |
| 8.0.2 | 31 | 02/13/2024 |
| 8.0.1 | 29 | 02/13/2024 |
| 8.0.0 | 28 | 02/13/2024 |
| 7.0.0 | 27 | 02/13/2024 |
| 6.0.0 | 17 | 02/13/2024 |
| 5.1.0 | 28 | 02/13/2024 |
| 5.0.1 | 32 | 02/13/2024 |
| 5.0.1-alpha-0002 | 20 | 02/13/2024 |
| 5.0.1-alpha-0001 | 20 | 02/13/2024 |
| 4.1.0 | 33 | 02/13/2024 |
| 4.0.1 | 21 | 02/13/2024 |
| 4.0.0 | 22 | 02/13/2024 |
| 4.0.0-alpha-0002 | 24 | 02/13/2024 |
| 4.0.0-alpha | 27 | 02/13/2024 |
| 3.0.1 | 29 | 02/13/2024 |
| 3.0.0 | 28 | 02/13/2024 |
| 2.1.0 | 28 | 02/13/2024 |
| 2.1.0-beta-19 | 28 | 02/13/2024 |
| 2.0.2 | 31 | 02/13/2024 |
| 2.0.1 | 28 | 02/13/2024 |
| 2.0.0 | 34 | 02/13/2024 |
| 2.0.0-beta-005 | 29 | 02/13/2024 |
| 2.0.0-beta-004 | 29 | 02/13/2024 |
| 2.0.0-beta-003 | 27 | 02/13/2024 |
| 2.0.0-beta-002 | 28 | 02/13/2024 |
| 2.0.0-beta-001 | 30 | 02/13/2024 |
| 1.0.0 | 27 | 02/13/2024 |
| 0.5.0 | 30 | 02/13/2024 |
| 0.4.0 | 22 | 02/13/2024 |
| 0.3.0 | 22 | 02/13/2024 |
| 0.2.0 | 30 | 02/13/2024 |
| 0.1.0 | 31 | 02/13/2024 |