FluentValidation 7.6.0

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

There is a newer version of this package available.
See the version list below for details.
Install-Package FluentValidation -Version 7.6.0
dotnet add package FluentValidation --version 7.6.0
<PackageReference Include="FluentValidation" Version="7.6.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add FluentValidation --version 7.6.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Release Notes

Changes in 7.6:
* WhenAsync now works correctly when calling the non-async Validate method.
* ASP.NET Core integration has been updated to ASP.NET Core 2.1.
* Include statement now works when explicitly selecting properties to validate.
* Added Ukranian language support.
* Added Arabic language support.

Changes in 7.5.2:
* RuleSet method can now take multiple ruleset names by usinga comma-separated string.
* Make setters on ValidationFailure's properties public to allow for easier deserialization.
* Additional overload for OverridePropertyName that takes an expression.
* Add overload of Include that takes a func to lazily create the inner validator.
* Make error code resolution pluggable using ValidatorOptions.ErrorCodeResolver
       
Changes in 7.5.1:
* Resolved issues with referencing FluentValidation from legacy PCLs.
* Added support for CustomizeValidatorAttribute to the legacy WebApi integration for consistency with MVC5 and AspNetCore.

Changes in 7.5:
* Better handling of clientside messages when using custom overriden language resources
* Added flag in the ValidationContext's RootDataContext when a validator is invoked by the automatic MVC/WebApi integration
* Improvements to some of the validation tester's messages
* Added Transform method to transform property values prior to validation
* Improve support for DisplayAttribute / DisplayNameAttribute when inferring property display name
* New language translations (Slovak/Hebrew/Brazilian Portuguese)
* Cache display names by default
* Ensure ShouldHaveChildValidator test method works with model-level rules
* Removed netstandard1.0 support. Supported platforms are now netstandard1.1, netstandard2.0 and net45.

Changes in 7.4:
* Improved syntax for DependentRules
* ValidationException serialization support when running on full framework
* Added ComparisonProperty placeholder to some validators
* The Test Helper now correctly handles read-only properties
* Add CancellationToken support to ValidateAndThrowAsync and various ValidateAsync overloads
* Improved functionality for custom MessageBuilders
* Updated AspNetCore integration to MVC version 2.0.2
* Update MVC5 AddToModelState extension not to overwrite existing attempted values
* Added SetRulesetForClientsideMessages method for MVC5/AspNetCore as an alternative to using the RulesetForClientSideMessagesAttribute

Changes in 7.3:
* Major changes to AspNetCore integration including better support for collections and implicit validation (opt-in)
* Fix - Updated EnumValidator's Flags support to handle the ~0 value
* Fix - TestHelper checking for child validator would respond with the wrong type
* Fix - Updated translations for some validators
* Fix - Overload of WithName that takes a lambda generated an exception
* Added versions of WhenAsync and UnlessAsync that support CancellationTokens
* Simplify calls to DependentRules
* Add Skip property to CustomizeValidatorAttribute in the ASP.NET Core integration

Changes in 7.2:
* Updated AspNetCore integration to support IValidatableObject
* Updated AspNetCore integration to allow mixing multiple validation strategies in the same model
* Updated AspNetCore integration to support RulesetForClientsideMessagesAttribute
* Fix - Property names were not generated properly for nested types when using AddFailure inside a Custom validator
* Fix - NullReferenceException when using CustomAsync but the validator is invoked synchronously
* Fix - Clientside integration in AspNetCore being resolved from the root-level service provider
* Fix - Allow empty string to be passed to OverridePropertyName

Changes in 7.1.1:
* Fix - Incorrect property name was generated when using RuleForEach combined with SetValidator
* Fix - Nesting async validators inside DependentRules didn't wait for completion

Changes in 7.1:
* New RuleFor().Custom() method as a replacement for the old, deprecated Custom method
* Improved messages in the ShouldHaveChildValidator test extension
* Test helper works with nested properties
* Additional overload of WithState allows access to collection item when used with RuleForEach
* Fix - Wrong values were generated as part of the MVC5 clientside integration for MinLength and MaxLength validators
* Fix - AssemblyScanner now excludes abstract and generic types
* Fix - InvalidCastException when using lazy WithMessage combined with RuleForEach
* WithState enhanced to allow access to the ValidationContext

Changes in 7.0:

7.0 is a major release that contains several breaking changes, especially with Localization. If you use FluentValidation's support for localization please read the updated documentation: https://github.com/JeremySkinner/FluentValidation/wiki/f.-Localization

* Localization rewrite to not require satellite assemblies
* New 'Custom' rule method replaces the root-level Custom method
* Switch to Netstandard based build process
* Assemblies are now signed / strongly named - see https://github.com/JeremySkinner/FluentValidation/wiki/l.-Strong-naming-and-signed-packages
* Fix - Possible NullReferenceException in the AspNetCore clientside integration for length validators
* Fix - Don't clear the ModelValidatorProviders collection by default in the AspNetCore integration (added new ClearValidatorProviders property to control this behaviour)
* Fix - Ensure IValidatorFactory is resolved from request scope in asp.net core integration
* Fix - Property getter that throws an exception causes validation to fail in WebApi integration
* Fix - Issue in AspNetCore integration where we tried to resolve a collection validator in some situations where a class validator should be used
* Fix - Incorrect clientside validation attributes generated for email validator and credit card validator in the asp.net core integration
* Fix - Child model validation now works in webapi integration
* Improve splitting of PascalCased property names to support uppercase character sequences
* ValidationResult.ErrorCode property now always returns the type of the PropertyValidator that generated the message, unless it's been explicitly overriden

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 3.1 application with DDD, CQRS and Event Sourcing concepts
jasontaylordev/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
kgrzybek/modular-monolith-with-ddd
Full Modular Monolith application with Domain-Driven Design approach.
canton7/SyncTrayzor
Windows tray utility / filesystem watcher / launcher for Syncthing

Read more about the GitHub Usage information on our documentation.

Version History

Version Downloads Last updated
9.0.0-preview5 264 5/23/2020
9.0.0-preview4 6,721 4/22/2020
9.0.0-preview3 27,902 2/29/2020
9.0.0-preview2 8,290 2/21/2020
9.0.0-preview1 17,710 2/8/2020
8.6.2 1,243,182 2/29/2020
8.6.1 1,852,511 12/28/2019
8.6.0 1,025,185 12/4/2019
8.5.1 930,970 11/2/2019
8.5.0 1,419,948 9/24/2019
8.5.0-preview5 37,510 9/1/2019
8.5.0-preview4 62,175 7/23/2019
8.5.0-preview3 25,109 7/10/2019
8.5.0-preview2 32,976 6/13/2019
8.5.0-preview1 38,672 5/10/2019
8.4.0 4,562,528 5/10/2019
8.3.0 596,906 4/24/2019
8.2.3 257,712 4/12/2019
8.2.2 397,884 4/5/2019
8.2.1 66,971 4/4/2019
8.2.0 432,866 3/26/2019
8.1.3 2,482,352 1/25/2019
8.1.2 1,010,873 12/18/2018
8.1.1 276,979 12/11/2018
8.1.0 198,214 12/6/2018
8.1.0-preview2 24,737 11/14/2018
8.1.0-preview1 24,845 10/14/2018
8.0.101 340,924 11/24/2018
8.0.100 1,809,406 9/4/2018
8.0.0 402,723 8/16/2018
8.0.0-rc1 33,437 7/24/2018
8.0.0-preview4 21,636 7/16/2018
8.0.0-preview3 20,475 7/13/2018
8.0.0-preview2 20,234 7/13/2018
7.6.105 362,601 8/11/2018
7.6.104 1,316,895 7/6/2018
7.6.103 569,300 6/16/2018
7.6.102 138,346 6/14/2018
7.6.101 57,903 6/13/2018
7.6.100 106,706 6/7/2018
7.6.0 215,382 6/1/2018
7.6.0-preview1 29,715 4/12/2018
7.5.2 1,579,632 3/16/2018
7.5.1 132,847 3/11/2018
7.5.0 428,197 2/26/2018
7.4.0 617,230 1/26/2018
7.3.4 512,627 1/2/2018
7.3.3 123,491 12/22/2017
7.3.2 41,081 12/21/2017
7.3.1 154,345 12/13/2017
7.3.0 29,994 12/13/2017
7.3.0-beta3 24,968 12/8/2017
7.3.0-beta2 35,742 11/20/2017
7.3.0-beta1 21,923 11/11/2017
7.2.1 1,271,982 10/24/2017
7.2.0 426,235 10/5/2017
7.2.0-beta3 37,224 9/5/2017
7.2.0-beta2 23,487 8/22/2017
7.2.0-beta1 20,437 8/19/2017
7.1.1 916,446 7/25/2017
7.1.0 292,511 6/28/2017
7.1.0-beta1 20,288 6/24/2017
7.0.3 228,073 6/7/2017
7.0.2 148,636 5/26/2017
7.0.1 54,868 5/23/2017
7.0.0 189,477 5/19/2017
7.0.0-beta3 24,119 5/1/2017
7.0.0-beta2 23,905 4/17/2017
7.0.0-beta1 21,437 4/7/2017
6.4.1 610,756 3/15/2017
6.4.1-beta1 21,191 3/13/2017
6.4.0 442,754 3/3/2017
6.4.0-rc4 142,320 2/13/2017
6.4.0-rc3 29,662 2/3/2017
6.4.0-rc2 36,370 1/30/2017
6.4.0-rc1 20,286 1/30/2017
6.4.0-beta9 74,850 11/21/2016
6.4.0-beta8 45,419 10/31/2016
6.4.0-beta7 20,846 10/28/2016
6.4.0-beta6 21,264 10/25/2016
6.4.0-beta5 20,961 10/24/2016
6.4.0-beta4 20,974 10/21/2016
6.4.0-beta3 61,770 7/4/2016
6.4.0-beta2 21,820 7/1/2016
6.4.0-beta10 20,141 1/30/2017
6.4.0-beta1 23,966 6/28/2016
6.3.4-alpha 191,749 6/1/2016
6.3.3-alpha 20,574 5/27/2016
6.2.1 2,031,841 2/26/2016
6.2.1-beta1 24,352 2/24/2016
6.2.0 69,335 2/22/2016
6.2.0-beta1 20,596 2/12/2016
6.1.0 223,193 1/18/2016
6.0.2 84,449 1/5/2016
6.0.1 32,736 1/5/2016
6.0.0 57,327 12/22/2015
5.6.2 730,920 5/29/2015
5.6.1 26,253 5/29/2015
5.5.0 552,535 10/31/2014
5.4.0 315,383 7/3/2014
5.3.0 72,121 5/27/2014
5.2.0 45,374 5/21/2014
5.1.0 325,547 3/11/2014
5.0.0.1 186,010 10/24/2013
4.0.0.1 153,812 7/18/2013
4.0.0 82,650 4/29/2013
3.4.6 202,499 8/30/2012
3.4.0 45,757 8/17/2012
3.3.1 39,640 3/30/2012
3.2.0 52,719 11/14/2011
3.1.0 46,545 7/30/2011
3.0.0.1 22,352 7/5/2011
3.0.0 25,120 6/25/2011
2.0.0 38,228 1/9/2011
1.3.0 39,718 1/7/2011
Show less