MediatR 12.4.1
dotnet add package MediatR --version 12.4.1
NuGet\Install-Package MediatR -Version 12.4.1
<PackageReference Include="MediatR" Version="12.4.1" />
paket add MediatR --version 12.4.1
#r "nuget: MediatR, 12.4.1"
// Install MediatR as a Cake Addin #addin nuget:?package=MediatR&version=12.4.1 // Install MediatR as a Cake Tool #tool nuget:?package=MediatR&version=12.4.1
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)INotification
IStreamRequest
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:
IMediator
as transientISender
as transientIPublisher
as 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.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- MediatR.Contracts (>= 2.0.1 && < 3.0.0)
- Microsoft.Bcl.AsyncInterfaces (>= 8.0.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.0)
-
net6.0
- MediatR.Contracts (>= 2.0.1 && < 3.0.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.0)
NuGet packages (2.0K)
Showing the top 5 NuGet packages that depend on MediatR:
Package | Downloads |
---|---|
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core |
|
MediatR.Extensions.Autofac.DependencyInjection
An extension for Autofac-IoC to use MediatR and CQRS with ease. |
|
NET6CustomLibrary
open source custom dotnet extension library |
|
Elsa.Abstractions
Elsa is a set of workflow libraries and tools that enable lean and mean workflowing capabilities in any .NET Core application. This package provides abstractions and models that are used by Elsa.Core and other related packages. You don't need to reference this package separately if you reference any other Elsa package. |
|
Elsa.Core
Elsa is a set of workflow libraries and tools that enable lean and mean workflowing capabilities in any .NET Core application. This package contains the core of Elsa. Tip: reference the `Elsa` package instead of this one. |
GitHub repositories (185)
Showing the top 5 popular GitHub repositories that depend on MediatR:
Repository | Stars |
---|---|
jasontaylordev/CleanArchitecture
Clean Architecture Solution Template for ASP.NET Core
|
|
ardalis/CleanArchitecture
Clean Architecture Solution Template: A starting point for Clean Architecture with ASP.NET Core
|
|
kgrzybek/modular-monolith-with-ddd
Full Modular Monolith application with Domain-Driven Design approach.
|
|
dotnet-architecture/eShopOnWeb
Sample ASP.NET Core 8.0 reference application, powered by Microsoft, demonstrating a layered application architecture with monolithic deployment model. Download the eBook PDF from docs folder.
|
|
MassTransit/MassTransit
Distributed Application Framework for .NET
|
Version | Downloads | Last updated |
---|---|---|
12.4.1 | 1,268,657 | 9/9/2024 |
12.4.0 | 2,555,763 | 7/23/2024 |
12.3.0 | 3,663,534 | 6/6/2024 |
12.2.0 | 18,496,624 | 11/17/2023 |
12.1.1 | 13,663,451 | 7/10/2023 |
12.0.1 | 15,203,762 | 2/23/2023 |
11.1.0 | 12,462,333 | 11/19/2022 |
11.0.0 | 15,417,458 | 9/30/2022 |
10.0.1 | 34,592,404 | 1/10/2022 |
10.0.0 | 882,293 | 1/6/2022 |
9.0.0 | 56,183,508 | 10/8/2020 |
8.1.0 | 10,813,914 | 7/27/2020 |
8.0.2 | 2,263,383 | 6/30/2020 |
8.0.1 | 10,203,866 | 2/27/2020 |
8.0.0 | 8,460,196 | 12/30/2019 |
7.0.0 | 12,119,092 | 4/30/2019 |
6.0.0 | 6,346,661 | 12/10/2018 |
5.1.0 | 3,007,510 | 7/30/2018 |
5.0.1 | 927,210 | 6/1/2018 |
5.0.1-alpha-0002 | 41,315 | 4/5/2018 |
5.0.1-alpha-0001 | 3,480 | 4/5/2018 |
4.1.0 | 2,006,923 | 3/20/2018 |
4.0.1 | 1,040,407 | 12/4/2017 |
4.0.0 | 157,306 | 11/30/2017 |
4.0.0-alpha-0002 | 3,500 | 11/30/2017 |
4.0.0-alpha | 4,853 | 11/29/2017 |
3.0.1 | 1,375,723 | 3/7/2017 |
3.0.0 | 306,067 | 1/4/2017 |
2.1.0 | 754,720 | 7/1/2016 |
2.1.0-beta-19 | 4,190 | 5/23/2016 |
2.0.2 | 354,386 | 8/5/2015 |
2.0.1 | 5,180 | 8/5/2015 |
2.0.0 | 9,624 | 8/4/2015 |
2.0.0-beta-005 | 5,402 | 7/2/2015 |
2.0.0-beta-004 | 17,547 | 4/20/2015 |
2.0.0-beta-003 | 4,521 | 4/20/2015 |
2.0.0-beta-002 | 3,699 | 4/19/2015 |
2.0.0-beta-001 | 5,935 | 2/16/2015 |
1.0.0 | 60,046 | 12/16/2014 |
0.5.0 | 11,743 | 7/7/2014 |
0.4.0 | 4,020 | 6/16/2014 |
0.3.0 | 4,854 | 3/20/2014 |
0.2.0 | 4,942 | 3/6/2014 |
0.1.0 | 129,718 | 3/4/2014 |