FluentValidation 7.5.1

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

Release Notes

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 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
ABP vNext
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-preview4 5,216 7/23/2019
8.5.0-preview3 2,208 7/10/2019
8.5.0-preview2 6,384 6/13/2019
8.5.0-preview1 8,567 5/10/2019
8.4.0 817,077 5/10/2019
8.3.0 184,613 4/24/2019
8.2.3 112,436 4/12/2019
8.2.2 183,824 4/5/2019
8.2.1 19,361 4/4/2019
8.2.0 174,320 3/26/2019
8.1.3 1,213,876 1/25/2019
8.1.2 583,410 12/18/2018
8.1.1 147,040 12/11/2018
8.1.0 95,340 12/6/2018
8.1.0-preview2 4,404 11/14/2018
8.1.0-preview1 4,254 10/14/2018
8.0.101 217,191 11/24/2018
8.0.100 1,144,210 9/4/2018
8.0.0 266,454 8/16/2018
8.0.0-rc1 12,823 7/24/2018
8.0.0-preview4 1,943 7/16/2018
8.0.0-preview3 925 7/13/2018
8.0.0-preview2 669 7/13/2018
7.6.105 173,526 8/11/2018
7.6.104 865,862 7/6/2018
7.6.103 379,472 6/16/2018
7.6.102 85,431 6/14/2018
7.6.101 21,208 6/13/2018
7.6.100 53,995 6/7/2018
7.6.0 138,691 6/1/2018
7.6.0-preview1 8,439 4/12/2018
7.5.2 1,152,063 3/16/2018
7.5.1 70,937 3/11/2018
7.5.0 267,869 2/26/2018
7.4.0 424,930 1/26/2018
7.3.4 342,357 1/2/2018
7.3.3 85,633 12/22/2017
7.3.2 14,205 12/21/2017
7.3.1 101,800 12/13/2017
7.3.0 6,899 12/13/2017
7.3.0-beta3 5,426 12/8/2017
7.3.0-beta2 12,403 11/20/2017
7.3.0-beta1 2,228 11/11/2017
7.2.1 918,877 10/24/2017
7.2.0 280,092 10/5/2017
7.2.0-beta3 17,500 9/5/2017
7.2.0-beta2 3,842 8/22/2017
7.2.0-beta1 931 8/19/2017
7.1.1 727,393 7/25/2017
7.1.0 231,561 6/28/2017
7.1.0-beta1 801 6/24/2017
7.0.3 171,020 6/7/2017
7.0.2 105,834 5/26/2017
7.0.1 32,966 5/23/2017
7.0.0 107,703 5/19/2017
7.0.0-beta3 4,573 5/1/2017
7.0.0-beta2 4,371 4/17/2017
7.0.0-beta1 1,917 4/7/2017
6.4.1 469,888 3/15/2017
6.4.1-beta1 1,636 3/13/2017
6.4.0 349,991 3/3/2017
6.4.0-rc4 122,001 2/13/2017
6.4.0-rc3 10,007 2/3/2017
6.4.0-rc2 16,844 1/30/2017
6.4.0-rc1 778 1/30/2017
6.4.0-beta9 52,964 11/21/2016
6.4.0-beta8 24,316 10/31/2016
6.4.0-beta7 1,180 10/28/2016
6.4.0-beta6 1,572 10/25/2016
6.4.0-beta5 1,312 10/24/2016
6.4.0-beta4 1,309 10/21/2016
6.4.0-beta3 41,200 7/4/2016
6.4.0-beta2 2,126 7/1/2016
6.4.0-beta10 662 1/30/2017
6.4.0-beta1 4,071 6/28/2016
6.3.4-alpha 125,109 6/1/2016
6.3.3-alpha 1,059 5/27/2016
6.2.1 1,656,288 2/26/2016
6.2.1-beta1 4,801 2/24/2016
6.2.0 30,579 2/22/2016
6.2.0-beta1 1,071 2/12/2016
6.1.0 176,168 1/18/2016
6.0.2 55,085 1/5/2016
6.0.1 9,296 1/5/2016
6.0.0 29,073 12/22/2015
5.6.2 604,609 5/29/2015
5.6.1 6,233 5/29/2015
5.5.0 418,746 10/31/2014
5.4.0 250,048 7/3/2014
5.3.0 48,341 5/27/2014
5.2.0 20,041 5/21/2014
5.1.0 243,686 3/11/2014
5.0.0.1 143,100 10/24/2013
4.0.0.1 114,866 7/18/2013
4.0.0 58,405 4/29/2013
3.4.6 166,652 8/30/2012
3.4.0 23,565 8/17/2012
3.3.1 19,381 3/30/2012
3.2.0 32,106 11/14/2011
3.1.0 26,237 7/30/2011
3.0.0.1 2,763 7/5/2011
3.0.0 3,325 6/25/2011
2.0.0 14,137 1/9/2011
1.3.0 16,570 1/7/2011
Show less