FluentValidation 11.2.1
Prefix ReservedSee the version list below for details.
dotnet add package FluentValidation --version 11.2.1
NuGet\Install-Package FluentValidation -Version 11.2.1
<PackageReference Include="FluentValidation" Version="11.2.1" />
paket add FluentValidation --version 11.2.1
#r "nuget: FluentValidation, 11.2.1"
// Install FluentValidation as a Cake Addin #addin nuget:?package=FluentValidation&version=11.2.1 // Install FluentValidation as a Cake Tool #tool nuget:?package=FluentValidation&version=11.2.1
FluentValidation is validation library for .NET that uses a fluent interface and lambda expressions for building strongly-typed validation rules.
Supporting the project
If you use FluentValidation in a commercial project, please sponsor the project financially. FluentValidation is developed and supported by @JeremySkinner for free in his spare time and financial sponsorship helps keep the project going. You can sponsor the project via either GitHub sponsors or OpenCollective.
Example
With FluentValidation, you can define a class that inherits from AbstractValidator
which contains the rules for a particular class. The example below shows how you could define rules
for a Customer
class, and then how to execute the validator.
using FluentValidation;
public class CustomerValidator: AbstractValidator<Customer> {
public CustomerValidator() {
RuleFor(x => x.Surname).NotEmpty();
RuleFor(x => x.Forename).NotEmpty().WithMessage("Please specify a first name");
RuleFor(x => x.Discount).NotEqual(0).When(x => x.HasDiscount);
RuleFor(x => x.Address).Length(20, 250);
RuleFor(x => x.Postcode).Must(BeAValidPostcode).WithMessage("Please specify a valid postcode");
}
private bool BeAValidPostcode(string postcode) {
// custom postcode validating logic goes here
}
}
var customer = new Customer();
var validator = new CustomerValidator();
// Execute the validator.
ValidationResult results = validator.Validate(customer);
// Inspect any validation failures.
bool success = results.IsValid;
List<ValidationFailure> failures = results.Errors;
Full Documentation
Full documentation can be found at https://docs.fluentvalidation.net
Release Notes and Change Log
Release notes can be found on GitHub.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 is compatible. 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 is compatible. |
.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
- System.Threading.Tasks.Extensions (>= 4.5.2)
-
.NETStandard 2.1
- No dependencies.
-
net5.0
- No dependencies.
-
net6.0
- No dependencies.
NuGet packages (2.3K)
Showing the top 5 NuGet packages that depend on FluentValidation:
Package | Downloads |
---|---|
FluentValidation.DependencyInjectionExtensions
Dependency injection extensions for FluentValidation |
|
FluentValidation.AspNetCore
AspNetCore integration for FluentValidation |
|
MicroElements.Swashbuckle.FluentValidation
Swagger ISchemaFilter that uses FluentValidation validators instead System.ComponentModel based attributes. |
|
Ocelot
Ocelot is an API gateway based on .NET stack. |
|
Reo.Core.Validation
Package Description |
GitHub repositories (215)
Showing the top 5 popular GitHub repositories that depend on FluentValidation:
Repository | Stars |
---|---|
abpframework/abp
Open-source web application framework for ASP.NET Core! Offers an opinionated architecture to build enterprise software solutions with best practices on top of the .NET. Provides the fundamental infrastructure, cross-cutting-concern implementations, startup templates, application modules, UI themes, tooling and documentation.
|
|
aspnetboilerplate/aspnetboilerplate
ASP.NET Boilerplate - Web Application Framework
|
|
kgrzybek/modular-monolith-with-ddd
Full Modular Monolith application with Domain-Driven Design approach.
|
|
Sonarr/Sonarr
Smart PVR for newsgroup and bittorrent users.
|
|
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.
|
Version | Downloads | Last updated |
---|---|---|
11.10.0 | 2,633,885 | 9/15/2024 |
11.9.2 | 10,777,393 | 6/10/2024 |
11.9.1 | 6,580,256 | 4/23/2024 |
11.9.0 | 19,826,904 | 12/21/2023 |
11.8.1 | 5,270,518 | 11/22/2023 |
11.8.0 | 6,496,404 | 10/19/2023 |
11.7.1 | 8,807,939 | 8/12/2023 |
11.7.0 | 105,105 | 8/11/2023 |
11.6.0 | 6,793,930 | 7/4/2023 |
11.5.2 | 15,231,147 | 4/7/2023 |
11.5.1 | 34,832,117 | 2/20/2023 |
11.5.0 | 2,092,463 | 2/13/2023 |
11.4.0 | 15,862,250 | 11/23/2022 |
11.3.0 | 2,980,867 | 11/10/2022 |
11.2.2 | 13,813,536 | 9/11/2022 |
11.2.1 | 19,775,702 | 8/28/2022 |
11.2.0 | 6,875,796 | 8/8/2022 |
11.1.1 | 560,472 | 8/6/2022 |
11.1.0 | 11,343,075 | 6/22/2022 |
11.0.3 | 3,048,393 | 6/10/2022 |
11.0.2 | 4,389,655 | 5/27/2022 |
11.0.1 | 5,908,085 | 5/7/2022 |
11.0.0 | 4,674,627 | 4/30/2022 |
10.4.0 | 17,533,849 | 3/11/2022 |
10.3.6 | 24,030,368 | 12/13/2021 |
10.3.5 | 2,949,321 | 11/30/2021 |
10.3.4 | 9,163,316 | 10/22/2021 |
10.3.3 | 10,825,054 | 8/24/2021 |
10.3.1 | 672,086 | 8/19/2021 |
10.3.0 | 7,647,280 | 7/9/2021 |
10.2.3 | 7,570,606 | 6/3/2021 |
10.2.2 | 425,103 | 6/1/2021 |
10.2.1 | 1,265,756 | 5/30/2021 |
10.2.0 | 341,775 | 5/28/2021 |
10.1.0 | 4,888,506 | 4/28/2021 |
10.0.4 | 3,950,425 | 4/17/2021 |
9.5.4 | 4,980,073 | 4/5/2021 |
9.5.3 | 3,809,833 | 3/15/2021 |
9.5.2 | 1,814,793 | 3/8/2021 |
9.5.1 | 6,351,378 | 2/11/2021 |
9.5.0 | 3,003,944 | 1/31/2021 |
9.4.0 | 2,878,926 | 1/14/2021 |
9.3.0 | 13,394,681 | 11/10/2020 |
9.3.0-preview3 | 37,145 | 10/19/2020 |
9.3.0-preview2 | 145,958 | 9/15/2020 |
9.3.0-preview1 | 12,989 | 8/26/2020 |
9.2.2 | 6,775,256 | 9/20/2020 |
9.2.1 | 26,914 | 9/19/2020 |
9.2.0 | 7,455,902 | 8/26/2020 |
9.1.3 | 993,766 | 8/19/2020 |
9.1.2 | 908,029 | 8/12/2020 |
9.1.1 | 647,460 | 8/8/2020 |
9.1.0 | 171,822 | 8/8/2020 |
9.0.1 | 5,134,022 | 7/14/2020 |
9.0.0-preview5 | 88,074 | 5/23/2020 |
9.0.0-preview4 | 140,267 | 4/22/2020 |
9.0.0-preview3 | 193,186 | 2/29/2020 |
9.0.0-preview2 | 32,116 | 2/21/2020 |
9.0.0-preview1 | 94,472 | 2/8/2020 |
8.6.3 | 6,250,377 | 8/28/2020 |
8.6.2 | 26,285,644 | 2/29/2020 |
8.6.1 | 11,948,487 | 12/28/2019 |
8.6.0 | 4,022,967 | 12/4/2019 |
8.5.1 | 3,651,447 | 11/2/2019 |
8.5.0 | 5,818,972 | 9/24/2019 |
8.5.0-preview5 | 67,007 | 9/1/2019 |
8.5.0-preview4 | 94,076 | 7/23/2019 |
8.5.0-preview3 | 31,273 | 7/10/2019 |
8.5.0-preview2 | 76,490 | 6/13/2019 |
8.5.0-preview1 | 58,264 | 5/10/2019 |
8.4.0 | 13,532,372 | 5/10/2019 |
8.3.0 | 3,827,597 | 4/24/2019 |
8.2.3 | 656,543 | 4/12/2019 |
8.2.2 | 979,753 | 4/5/2019 |
8.2.1 | 446,646 | 4/4/2019 |
8.2.0 | 1,029,630 | 3/26/2019 |
8.1.3 | 4,976,509 | 1/25/2019 |
8.1.2 | 2,266,591 | 12/18/2018 |
8.1.1 | 571,745 | 12/11/2018 |
8.1.0 | 674,286 | 12/6/2018 |
8.1.0-preview2 | 29,123 | 11/14/2018 |
8.1.0-preview1 | 27,577 | 10/14/2018 |
8.0.101 | 833,925 | 11/24/2018 |
8.0.100 | 3,794,969 | 9/4/2018 |
8.0.0 | 1,045,842 | 8/16/2018 |
8.0.0-rc1 | 52,566 | 7/24/2018 |
8.0.0-preview4 | 25,542 | 7/16/2018 |
8.0.0-preview3 | 24,057 | 7/13/2018 |
8.0.0-preview2 | 23,860 | 7/13/2018 |
7.6.105 | 1,561,249 | 8/11/2018 |
7.6.104 | 2,695,906 | 7/6/2018 |
7.6.103 | 1,250,078 | 6/16/2018 |
7.6.102 | 313,049 | 6/14/2018 |
7.6.101 | 75,404 | 6/13/2018 |
7.6.100 | 169,382 | 6/7/2018 |
7.6.0 | 384,464 | 6/1/2018 |
7.6.0-preview1 | 48,428 | 4/12/2018 |
7.5.2 | 3,722,271 | 3/16/2018 |
7.5.1 | 258,609 | 3/11/2018 |
7.5.0 | 730,539 | 2/26/2018 |
7.4.0 | 1,845,664 | 1/26/2018 |
7.3.4 | 1,035,140 | 1/2/2018 |
7.3.3 | 183,466 | 12/22/2017 |
7.3.2 | 71,238 | 12/21/2017 |
7.3.1 | 322,631 | 12/13/2017 |
7.3.0 | 98,212 | 12/13/2017 |
7.3.0-beta3 | 27,943 | 12/8/2017 |
7.3.0-beta2 | 45,452 | 11/20/2017 |
7.3.0-beta1 | 24,890 | 11/11/2017 |
7.2.1 | 2,737,612 | 10/24/2017 |
7.2.0 | 797,412 | 10/5/2017 |
7.2.0-beta3 | 41,264 | 9/5/2017 |
7.2.0-beta2 | 27,076 | 8/22/2017 |
7.2.0-beta1 | 23,333 | 8/19/2017 |
7.1.1 | 1,980,739 | 7/25/2017 |
7.1.0 | 540,680 | 6/28/2017 |
7.1.0-beta1 | 23,100 | 6/24/2017 |
7.0.3 | 733,550 | 6/7/2017 |
7.0.2 | 277,824 | 5/26/2017 |
7.0.1 | 82,195 | 5/23/2017 |
7.0.0 | 628,511 | 5/19/2017 |
7.0.0-beta3 | 27,681 | 5/1/2017 |
7.0.0-beta2 | 26,773 | 4/17/2017 |
7.0.0-beta1 | 24,336 | 4/7/2017 |
6.4.1 | 1,736,503 | 3/15/2017 |
6.4.1-beta1 | 23,466 | 3/13/2017 |
6.4.0 | 893,123 | 3/3/2017 |
6.4.0-rc4 | 146,044 | 2/13/2017 |
6.4.0-rc3 | 39,143 | 2/3/2017 |
6.4.0-rc2 | 39,437 | 1/30/2017 |
6.4.0-rc1 | 23,235 | 1/30/2017 |
6.4.0-beta9 | 90,576 | 11/21/2016 |
6.4.0-beta8 | 50,231 | 10/31/2016 |
6.4.0-beta7 | 23,832 | 10/28/2016 |
6.4.0-beta6 | 24,152 | 10/25/2016 |
6.4.0-beta5 | 23,771 | 10/24/2016 |
6.4.0-beta4 | 23,889 | 10/21/2016 |
6.4.0-beta3 | 70,635 | 7/4/2016 |
6.4.0-beta2 | 24,758 | 7/1/2016 |
6.4.0-beta10 | 22,970 | 1/30/2017 |
6.4.0-beta1 | 28,061 | 6/28/2016 |
6.3.4-alpha | 402,645 | 6/1/2016 |
6.3.3-alpha | 22,786 | 5/27/2016 |
6.2.1 | 4,947,411 | 2/26/2016 |
6.2.1-beta1 | 28,199 | 2/24/2016 |
6.2.0 | 160,714 | 2/22/2016 |
6.2.0-beta1 | 24,040 | 2/12/2016 |
6.1.0 | 401,901 | 1/18/2016 |
6.0.2 | 112,577 | 1/5/2016 |
6.0.1 | 38,751 | 1/5/2016 |
6.0.0 | 124,013 | 12/22/2015 |
5.6.2 | 1,448,934 | 5/29/2015 |
5.6.1 | 33,791 | 5/29/2015 |
5.5.0 | 1,140,892 | 10/31/2014 |
5.4.0 | 584,093 | 7/3/2014 |
5.3.0 | 102,074 | 5/27/2014 |
5.2.0 | 73,716 | 5/21/2014 |
5.1.0 | 961,339 | 3/11/2014 |
5.0.0.1 | 486,441 | 10/24/2013 |
4.0.0.1 | 283,675 | 7/18/2013 |
4.0.0 | 112,000 | 4/29/2013 |
3.4.6 | 393,264 | 8/30/2012 |
3.4.0 | 65,984 | 8/17/2012 |
3.3.1 | 83,879 | 3/30/2012 |
3.2.0 | 72,217 | 11/14/2011 |
3.1.0 | 52,293 | 7/30/2011 |
3.0.0.1 | 25,915 | 7/5/2011 |
3.0.0 | 42,910 | 6/25/2011 |
2.0.0 | 71,333 | 1/9/2011 |
1.3.0 | 230,686 | 1/7/2011 |
FluentValidation 11 is a major release. Please read the upgrade guide at https://docs.fluentvalidation.net/en/latest/upgrading-to-11.html
Full release notes can be found at https://github.com/FluentValidation/FluentValidation/releases