FluentValidation 9.0.0-preview1

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

This is a prerelease version of FluentValidation.
There is a newer version of this package available.
See the version list below for details.
Install-Package FluentValidation -Version 9.0.0-preview1
dotnet add package FluentValidation --version 9.0.0-preview1
<PackageReference Include="FluentValidation" Version="9.0.0-preview1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add FluentValidation --version 9.0.0-preview1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: FluentValidation, 9.0.0-preview1"
For F# scripts that support #r syntax, copy this into the source code to reference the package.

FluentValidation 9 is a major release. Please read the upgrade notes at https://docs.fluentvalidation.net/en/latest/upgrading-to-9.html

Changes in 9.0.0:

  • Removed support for netstandard1.1 and netstandard1.6
  • Default email validation mode now uses the same logic as ASP.NET Core. Previous regex behaviour is opt-in.
  • TestHelper advanced mode now has more features (see https://docs.fluentvalidation.net/en/latest/testing.html#advanced-test-extensions)
  • Equal/NotEqual now perform ordinal comparison when used with string properties
  • Severity can now be set dynamically with a callback
  • Removed WithLocalizedMessage (WithMessage that takes a callback is the replacement)
  • Removed ResourceName from ValidationFailure
  • Removed ResourceName and ResourceType from IStringSource.
  • Removed SetCollectionValidator which was deprecated in 8.0
  • Additional overload of OnAnyFailure that can receive a collection of validation failures
  • Remove DisplayAttribute integration and reference to DataAnnotations.
  • ComparisonProperty placeholder is now formatted like PropertyName
  • Translations of default error messages into other languages are now lazily-loaded

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

FluentValidation 9 is a major release. Please read the upgrade notes at https://docs.fluentvalidation.net/en/latest/upgrading-to-9.html

Changes in 9.0.0:

  • Removed support for netstandard1.1 and netstandard1.6
  • Default email validation mode now uses the same logic as ASP.NET Core. Previous regex behaviour is opt-in.
  • TestHelper advanced mode now has more features (see https://docs.fluentvalidation.net/en/latest/testing.html#advanced-test-extensions)
  • Equal/NotEqual now perform ordinal comparison when used with string properties
  • Severity can now be set dynamically with a callback
  • Removed WithLocalizedMessage (WithMessage that takes a callback is the replacement)
  • Removed ResourceName from ValidationFailure
  • Removed ResourceName and ResourceType from IStringSource.
  • Removed SetCollectionValidator which was deprecated in 8.0
  • Additional overload of OnAnyFailure that can receive a collection of validation failures
  • Remove DisplayAttribute integration and reference to DataAnnotations.
  • ComparisonProperty placeholder is now formatted like PropertyName
  • Translations of default error messages into other languages are now lazily-loaded

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

Release Notes

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

Changes in 8.6.0:
* Add support for ASP.NET Core 3.1
* Fixed issue with property indexers being incorrectly stripped out when using test extensions.
* AddToModelState no longer includes a dot if PropertyName is null

Changes in 8.5.1:
* Ensure lazily loaded calls to WithMessage can be used for client-side validation, provided they don't attempt to access model properties from inside the delegate (eg when using IStringLocalizer).
* Fix issue where OnFailure didn't work properly when invoked on validators with conditions.

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

  • .NETFramework 4.6.1

    • No dependencies.
  • .NETStandard 2.0

    • No dependencies.

NuGet packages (787)

Showing the top 5 NuGet packages that depend on FluentValidation:

Package Downloads
FluentValidation.AspNetCore
AspNetCore integration for FluentValidation
FluentValidation.DependencyInjectionExtensions
Dependency injection extensions for FluentValidation
FluentValidation.WebAPI
ASP.NET WebApi integration for FluentValidation
FluentValidation.MVC5
ASP.NET MVC 5 integration for FluentValidation
FluentValidation.ValidatorAttribute
A validation library for .NET that uses a fluent interface to construct strongly-typed validation rules.

GitHub repositories (96)

Showing the top 5 popular 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
abpframework/abp
Open Source Web Application Framework for ASP.NET Core

Version History

Version Downloads Last updated
10.0.0-preview1 812 2/24/2021
9.5.1 209,396 2/11/2021
9.5.0 218,675 1/31/2021
9.4.0 363,261 1/14/2021
9.3.0 1,701,898 11/10/2020
9.3.0-preview3 9,994 10/19/2020
9.3.0-preview2 39,411 9/15/2020
9.3.0-preview1 4,630 8/26/2020
9.2.2 1,503,438 9/20/2020
9.2.1 6,879 9/19/2020
9.2.0 1,927,701 8/26/2020
9.1.3 354,730 8/19/2020
9.1.2 245,801 8/12/2020
9.1.1 169,068 8/8/2020
9.1.0 4,862 8/8/2020
9.0.1 1,057,227 7/14/2020
9.0.0-preview5 42,139 5/23/2020
9.0.0-preview4 51,101 4/22/2020
9.0.0-preview3 91,751 2/29/2020
9.0.0-preview2 19,918 2/21/2020
9.0.0-preview1 43,120 2/8/2020
8.6.3 182,420 8/28/2020
8.6.2 8,262,103 2/29/2020
8.6.1 4,610,531 12/28/2019
8.6.0 1,868,137 12/4/2019
8.5.1 1,603,115 11/2/2019
8.5.0 2,450,817 9/24/2019
8.5.0-preview5 45,726 9/1/2019
8.5.0-preview4 71,686 7/23/2019
8.5.0-preview3 25,940 7/10/2019
8.5.0-preview2 37,703 6/13/2019
8.5.0-preview1 43,100 5/10/2019
8.4.0 6,802,988 5/10/2019
8.3.0 1,283,919 4/24/2019
8.2.3 352,894 4/12/2019
8.2.2 524,754 4/5/2019
8.2.1 83,852 4/4/2019
8.2.0 559,222 3/26/2019
8.1.3 3,171,219 1/25/2019
8.1.2 1,287,929 12/18/2018
8.1.1 376,774 12/11/2018
8.1.0 287,557 12/6/2018
8.1.0-preview2 25,636 11/14/2018
8.1.0-preview1 25,251 10/14/2018
8.0.101 413,009 11/24/2018
8.0.100 2,284,172 9/4/2018
8.0.0 521,982 8/16/2018
8.0.0-rc1 35,745 7/24/2018
8.0.0-preview4 22,050 7/16/2018
8.0.0-preview3 20,878 7/13/2018
8.0.0-preview2 20,627 7/13/2018
7.6.105 605,861 8/11/2018
7.6.104 1,592,416 7/6/2018
7.6.103 717,525 6/16/2018
7.6.102 162,884 6/14/2018
7.6.101 61,182 6/13/2018
7.6.100 128,983 6/7/2018
7.6.0 247,251 6/1/2018
7.6.0-preview1 33,365 4/12/2018
7.5.2 1,915,420 3/16/2018
7.5.1 161,015 3/11/2018
7.5.0 521,585 2/26/2018
7.4.0 769,044 1/26/2018
7.3.4 628,555 1/2/2018
7.3.3 141,694 12/22/2017
7.3.2 45,530 12/21/2017
7.3.1 196,664 12/13/2017
7.3.0 33,871 12/13/2017
7.3.0-beta3 25,285 12/8/2017
7.3.0-beta2 38,199 11/20/2017
7.3.0-beta1 22,280 11/11/2017
7.2.1 1,553,777 10/24/2017
7.2.0 495,745 10/5/2017
7.2.0-beta3 37,865 9/5/2017
7.2.0-beta2 23,944 8/22/2017
7.2.0-beta1 20,725 8/19/2017
7.1.1 1,066,879 7/25/2017
7.1.0 325,617 6/28/2017
7.1.0-beta1 20,565 6/24/2017
7.0.3 368,426 6/7/2017
7.0.2 171,734 5/26/2017
7.0.1 56,943 5/23/2017
7.0.0 245,936 5/19/2017
7.0.0-beta3 24,520 5/1/2017
7.0.0-beta2 24,201 4/17/2017
7.0.0-beta1 21,712 4/7/2017
6.4.1 754,735 3/15/2017
6.4.1-beta1 21,516 3/13/2017
6.4.0 535,607 3/3/2017
6.4.0-rc4 142,873 2/13/2017
6.4.0-rc3 30,187 2/3/2017
6.4.0-rc2 36,796 1/30/2017
6.4.0-rc1 20,607 1/30/2017
6.4.0-beta9 78,234 11/21/2016
6.4.0-beta8 46,681 10/31/2016
6.4.0-beta7 21,157 10/28/2016
6.4.0-beta6 21,578 10/25/2016
6.4.0-beta5 21,275 10/24/2016
6.4.0-beta4 21,306 10/21/2016
6.4.0-beta3 63,384 7/4/2016
6.4.0-beta2 22,158 7/1/2016
6.4.0-beta10 20,462 1/30/2017
6.4.0-beta1 24,331 6/28/2016
6.3.4-alpha 226,235 6/1/2016
6.3.3-alpha 20,870 5/27/2016
6.2.1 2,407,861 2/26/2016
6.2.1-beta1 24,724 2/24/2016
6.2.0 86,150 2/22/2016
6.2.0-beta1 20,948 2/12/2016
6.1.0 249,889 1/18/2016
6.0.2 88,985 1/5/2016
6.0.1 33,314 1/5/2016
6.0.0 66,507 12/22/2015
5.6.2 835,183 5/29/2015
5.6.1 27,193 5/29/2015
5.5.0 652,282 10/31/2014
5.4.0 377,030 7/3/2014
5.3.0 76,030 5/27/2014
5.2.0 50,603 5/21/2014
5.1.0 398,722 3/11/2014
5.0.0.1 217,972 10/24/2013
4.0.0.1 172,368 7/18/2013
4.0.0 87,333 4/29/2013
3.4.6 233,301 8/30/2012
3.4.0 50,985 8/17/2012
3.3.1 42,055 3/30/2012
3.2.0 54,486 11/14/2011
3.1.0 47,551 7/30/2011
3.0.0.1 22,683 7/5/2011
3.0.0 27,786 6/25/2011
2.0.0 42,297 1/9/2011
1.3.0 47,428 1/7/2011
Show less