FluentValidation 8.5.0

A validation library for .NET that uses a fluent interface to construct strongly-typed validation rules.

Install-Package FluentValidation -Version 8.5.0
dotnet add package FluentValidation --version 8.5.0
<PackageReference Include="FluentValidation" Version="8.5.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add FluentValidation --version 8.5.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Release Notes

FluentValidation 8 is a major release. Please read the upgrade notes at https://fluentvalidation.net/upgrading-to-8

Changes in 8.5.0:
* Add additional overload of the EmailAddress validator for compatibility with ASP.NET Core's default email validation.
* Simplify the advanced testhelper syntax.
* Add support for ASP.NET Core 3.
* Add support for defining child rules inline.
* ValidatorDescriptor now has consistent handling of model-level rules.
* RuleForEach can now access collection index in error message with {CollectionIndex} placeholder.
* Welsh language translations of default error messages.
* Hungrian language translations of default error messages.
* Indonesian language translations of default error messages.
* Using RuleForEach combined with When is now more intuitive.
* Fixed order of rule execution when using async validation.

Changes in 8.4.0:
* Added simplified version of several messages across all translations to aid with ASP.NET Clientside validation.
* New enum validator for string properties.

Changes in 8.3.0:
* Fix issue in ASP.NET Core integration with GetServiceProvider not working correctly when invoked against a CustomContext/MessageBuilderContext.
* Improved how LanguageStringSource works with error-code overrides.
* Fix thread-safety issue with use of PropertyValidatorOptions.Empty (now removed).
* Improved how calls to When/Unless are handled internally.
* DelegatingValidator is now marked as deprecated.
* Improvements to Croatian language translations.
* Improvements to Georgian language translations.
* Resolved subtle bug where top-level WhenAsync wouldn't work correctly when wrapping a top-level call to When.

Changes in 8.2.3:
* Fix issue in WebApi integration where DataAnnotations validators could generate duplicate messages when in the same project as FluentValidation.

Changes in 8.2.2:
* Fix FluentValidation.DependencyInjection package name.

Changes in 8.2.1:
* Resolved issue using InjectValidator with RuleForEach.
* Add support for a default IValidatorInterceptor to be registered with the ASP.NET Core Service Provider.

Changes in 8.2.0:
* Add extensions for injecting child validators using the ASP.NET Core Service Provider.
* Implement RuleFor(...).ForEach(...) as an alternative to RuleForEach.
* WithLocalizedMessage is deprecated. Use the overload of WithMessage that takes a Func instead.

Changes in 8.1.3:
* Resolved issue where clientside validation was incorrectly generating metadata for rules with shared conditions.
* ScalePrecisionValidator now has a public method in the fluent interface.
* Fix placeholder names in ScalePrecisionValidator for consistency.
* Updates to Portuguese (Brazil) translations.

Changes in 8.1.2:
* Fix issue where shared When/Unless conditions didn't execute correctly when used with RuleForEach.

Changes in 8.1.1:
* Added RuleSetsExecuted property on ValidationResult.
* Resolved issue introduced in 8.1 where the shared condition cache does not work correctly with RuleForEach (#970).

Changes in 8.1:
* Add format support in message placeholders.
* Added support for overriding indexers for collection rules.
* Allow error codes to be used to override localization key in the Language Manager.
* Additional error details are now shown in the ShouldNotHaveValidationErrorFor test extension.
* Conditions defined with root-level When/WhenAsync/Unless/UnlessAsync are now only executed once (instead of once for each rule).
* Support Otherwise method chained from root-level When/WhenAsync/Unless/UnlessAsync.
* Minor wording changes to default English error messages.
* Japanese translation of the default error messages.
* Added Skip property to MVC5's CustomizeValidatorAttribute for parity with AspNetCore and WebApi.
* Remove type constraint on the OverridePropertyName overload that takes an expression.

Added Skip property to MVC5's CustomizeValidatorAttribute to bring parity with AspNetCore and WebApi integration.
Changes in 8.0:
* Support validating only specific properties by path.
* Added OnFailure method
* Deprecated RuleFor(..).SetCollectionValidator in favour of RuleForEach(...).SetValidator
* IStringSource.GetString now takes a validation context instead of a model instance.
* Introduce PropertyValidatorOptions in order to clean up the IPropretyValidator interface.
* Moved the legacy ValidatorAttribute and AttributedValidatorFactory into a separate FluentValidation.Attributes package.
* Remove the pre-7.0 localization mechanism
* Remove the pre-7.0 methods for custom validation
* Removed many other deprecated methods

Full release notes can be found at https://github.com/JeremySkinner/FluentValidation/blob/master/Changelog.txt

Showing the top 10 GitHub repositories that depend on FluentValidation:

Repository Stars
aspnetboilerplate/aspnetboilerplate
ASP.NET Boilerplate - Web Application Framework
NancyFx/Nancy
Lightweight, low-ceremony, framework for building HTTP based services on .Net and Mono
Sonarr/Sonarr
Smart PVR for newsgroup and bittorrent users.
ThreeMammals/Ocelot
.NET core API Gateway
Radarr/Radarr
A fork of Sonarr to work with movies à la Couchpotato.
EduardoPires/EquinoxProject
Full ASP.NET Core 2.2 application with DDD, CQRS and Event Sourcing
JasonGT/NorthwindTraders
Northwind Traders is a sample application built using ASP.NET Core and Entity Framework Core.
abpframework/abp
Open Source Web Application Framework for ASP.NET Core
canton7/SyncTrayzor
Windows tray utility / filesystem watcher / launcher for Syncthing
exceptionless/Exceptionless
Exceptionless server and jobs

Version History

Version Downloads Last updated
8.5.0 88,808 9/24/2019
8.5.0-preview5 13,087 9/1/2019
8.5.0-preview4 38,427 7/23/2019
8.5.0-preview3 22,793 7/10/2019
8.5.0-preview2 28,318 6/13/2019
8.5.0-preview1 30,748 5/10/2019
8.4.0 1,838,106 5/10/2019
8.3.0 260,460 4/24/2019
8.2.3 163,545 4/12/2019
8.2.2 252,068 4/5/2019
8.2.1 43,750 4/4/2019
8.2.0 248,017 3/26/2019
8.1.3 1,568,165 1/25/2019
8.1.2 700,683 12/18/2018
8.1.1 194,897 12/11/2018
8.1.0 131,011 12/6/2018
8.1.0-preview2 23,912 11/14/2018
8.1.0-preview1 23,671 10/14/2018
8.0.101 262,891 11/24/2018
8.0.100 1,305,242 9/4/2018
8.0.0 311,363 8/16/2018
8.0.0-rc1 32,359 7/24/2018
8.0.0-preview4 21,276 7/16/2018
8.0.0-preview3 20,239 7/13/2018
8.0.0-preview2 19,997 7/13/2018
7.6.105 225,151 8/11/2018
7.6.104 974,693 7/6/2018
7.6.103 437,041 6/16/2018
7.6.102 114,141 6/14/2018
7.6.101 41,811 6/13/2018
7.6.100 77,116 6/7/2018
7.6.0 173,882 6/1/2018
7.6.0-preview1 27,895 4/12/2018
7.5.2 1,263,367 3/16/2018
7.5.1 95,421 3/11/2018
7.5.0 318,932 2/26/2018
7.4.0 482,721 1/26/2018
7.3.4 394,673 1/2/2018
7.3.3 108,485 12/22/2017
7.3.2 35,836 12/21/2017
7.3.1 130,979 12/13/2017
7.3.0 26,539 12/13/2017
7.3.0-beta3 24,746 12/8/2017
7.3.0-beta2 32,302 11/20/2017
7.3.0-beta1 21,583 11/11/2017
7.2.1 1,006,755 10/24/2017
7.2.0 331,786 10/5/2017
7.2.0-beta3 36,854 9/5/2017
7.2.0-beta2 23,189 8/22/2017
7.2.0-beta1 20,255 8/19/2017
7.1.1 785,442 7/25/2017
7.1.0 261,483 6/28/2017
7.1.0-beta1 20,108 6/24/2017
7.0.3 198,304 6/7/2017
7.0.2 132,479 5/26/2017
7.0.1 52,648 5/23/2017
7.0.0 139,957 5/19/2017
7.0.0-beta3 23,894 5/1/2017
7.0.0-beta2 23,677 4/17/2017
7.0.0-beta1 21,222 4/7/2017
6.4.1 518,134 3/15/2017
6.4.1-beta1 20,977 3/13/2017
6.4.0 386,691 3/3/2017
6.4.0-rc4 141,494 2/13/2017
6.4.0-rc3 29,344 2/3/2017
6.4.0-rc2 36,155 1/30/2017
6.4.0-rc1 20,097 1/30/2017
6.4.0-beta9 72,716 11/21/2016
6.4.0-beta8 43,817 10/31/2016
6.4.0-beta7 20,520 10/28/2016
6.4.0-beta6 20,932 10/25/2016
6.4.0-beta5 20,646 10/24/2016
6.4.0-beta4 20,661 10/21/2016
6.4.0-beta3 60,694 7/4/2016
6.4.0-beta2 21,495 7/1/2016
6.4.0-beta10 19,954 1/30/2017
6.4.0-beta1 23,473 6/28/2016
6.3.4-alpha 151,783 6/1/2016
6.3.3-alpha 20,370 5/27/2016
6.2.1 1,749,671 2/26/2016
6.2.1-beta1 24,122 2/24/2016
6.2.0 54,124 2/22/2016
6.2.0-beta1 20,391 2/12/2016
6.1.0 202,440 1/18/2016
6.0.2 76,622 1/5/2016
6.0.1 29,521 1/5/2016
6.0.0 51,190 12/22/2015
5.6.2 644,592 5/29/2015
5.6.1 25,652 5/29/2015
5.5.0 465,157 10/31/2014
5.4.0 274,865 7/3/2014
5.3.0 68,505 5/27/2014
5.2.0 40,317 5/21/2014
5.1.0 278,713 3/11/2014
5.0.0.1 168,551 10/24/2013
4.0.0.1 137,915 7/18/2013
4.0.0 78,670 4/29/2013
3.4.6 189,522 8/30/2012
3.4.0 43,339 8/17/2012
3.3.1 38,764 3/30/2012
3.2.0 51,566 11/14/2011
3.1.0 45,696 7/30/2011
3.0.0.1 22,090 7/5/2011
3.0.0 22,895 6/25/2011
2.0.0 34,299 1/9/2011
1.3.0 36,576 1/7/2011