FluentValidation 9.0.0-preview1

Prefix Reserved
This is a prerelease version of FluentValidation.
There is a newer version of this package available.
See the version list below for details.
dotnet add package FluentValidation --version 9.0.0-preview1                
NuGet\Install-Package FluentValidation -Version 9.0.0-preview1                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<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                
#r "nuget: FluentValidation, 9.0.0-preview1"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install FluentValidation as a Cake Addin
#addin nuget:?package=FluentValidation&version=9.0.0-preview1&prerelease

// Install FluentValidation as a Cake Tool
#tool nuget:?package=FluentValidation&version=9.0.0-preview1&prerelease                

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

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  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 was computed. 
.NET Framework net461 is compatible.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .NETFramework 4.6.1

    • No dependencies.
  • .NETStandard 2.0

    • No dependencies.

NuGet packages (2.1K)

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.

FluentValidation.WebAPI

ASP.NET WebApi integration for FluentValidation

GitHub repositories (200)

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.9.2 1,822,288 6/10/2024
11.9.1 3,653,111 4/23/2024
11.9.0 14,558,089 12/21/2023
11.8.1 3,978,554 11/22/2023
11.8.0 5,182,829 10/19/2023
11.7.1 7,676,652 8/12/2023
11.7.0 96,914 8/11/2023
11.6.0 5,978,857 7/4/2023
11.5.2 13,596,916 4/7/2023
11.5.1 26,782,405 2/20/2023
11.5.0 1,821,041 2/13/2023
11.4.0 14,434,577 11/23/2022
11.3.0 2,708,732 11/10/2022
11.2.2 12,665,533 9/11/2022
11.2.1 18,280,707 8/28/2022
11.2.0 6,465,318 8/8/2022
11.1.1 520,371 8/6/2022
11.1.0 10,564,217 6/22/2022
11.0.3 2,818,977 6/10/2022
11.0.2 4,036,333 5/27/2022
11.0.1 5,534,300 5/7/2022
11.0.0 4,075,303 4/30/2022
10.4.0 16,331,185 3/11/2022
10.3.6 22,700,745 12/13/2021
10.3.5 2,821,745 11/30/2021
10.3.4 8,659,840 10/22/2021
10.3.3 10,357,627 8/24/2021
10.3.1 645,309 8/19/2021
10.3.0 7,274,473 7/9/2021
10.2.3 7,210,210 6/3/2021
10.2.2 413,329 6/1/2021
10.2.1 1,218,662 5/30/2021
10.2.0 321,430 5/28/2021
10.1.0 4,667,894 4/28/2021
10.0.4 3,789,396 4/17/2021
9.5.4 4,488,049 4/5/2021
9.5.3 3,694,717 3/15/2021
9.5.2 1,735,409 3/8/2021
9.5.1 6,147,764 2/11/2021
9.5.0 2,855,997 1/31/2021
9.4.0 2,790,200 1/14/2021
9.3.0 12,787,599 11/10/2020
9.3.0-preview3 36,106 10/19/2020
9.3.0-preview2 142,861 9/15/2020
9.3.0-preview1 12,776 8/26/2020
9.2.2 6,561,815 9/20/2020
9.2.1 25,622 9/19/2020
9.2.0 7,256,890 8/26/2020
9.1.3 976,640 8/19/2020
9.1.2 883,496 8/12/2020
9.1.1 633,534 8/8/2020
9.1.0 144,689 8/8/2020
9.0.1 4,963,800 7/14/2020
9.0.0-preview5 86,698 5/23/2020
9.0.0-preview4 136,916 4/22/2020
9.0.0-preview3 187,934 2/29/2020
9.0.0-preview2 31,498 2/21/2020
9.0.0-preview1 92,280 2/8/2020
8.6.3 5,781,585 8/28/2020
8.6.2 25,323,839 2/29/2020
8.6.1 11,584,915 12/28/2019
8.6.0 3,912,340 12/4/2019
8.5.1 3,565,958 11/2/2019
8.5.0 5,551,819 9/24/2019
8.5.0-preview5 65,976 9/1/2019
8.5.0-preview4 92,126 7/23/2019
8.5.0-preview3 30,895 7/10/2019
8.5.0-preview2 73,347 6/13/2019
8.5.0-preview1 57,062 5/10/2019
8.4.0 13,090,688 5/10/2019
8.3.0 3,717,004 4/24/2019
8.2.3 636,797 4/12/2019
8.2.2 953,254 4/5/2019
8.2.1 430,268 4/4/2019
8.2.0 1,007,519 3/26/2019
8.1.3 4,889,990 1/25/2019
8.1.2 2,214,829 12/18/2018
8.1.1 556,074 12/11/2018
8.1.0 617,528 12/6/2018
8.1.0-preview2 29,048 11/14/2018
8.1.0-preview1 27,485 10/14/2018
8.0.101 801,729 11/24/2018
8.0.100 3,707,210 9/4/2018
8.0.0 1,014,108 8/16/2018
8.0.0-rc1 51,938 7/24/2018
8.0.0-preview4 25,402 7/16/2018
8.0.0-preview3 23,945 7/13/2018
8.0.0-preview2 23,761 7/13/2018
7.6.105 1,477,145 8/11/2018
7.6.104 2,647,452 7/6/2018
7.6.103 1,224,510 6/16/2018
7.6.102 297,774 6/14/2018
7.6.101 74,623 6/13/2018
7.6.100 165,932 6/7/2018
7.6.0 375,610 6/1/2018
7.6.0-preview1 47,243 4/12/2018
7.5.2 3,622,473 3/16/2018
7.5.1 250,981 3/11/2018
7.5.0 720,747 2/26/2018
7.4.0 1,698,968 1/26/2018
7.3.4 1,012,361 1/2/2018
7.3.3 180,801 12/22/2017
7.3.2 69,973 12/21/2017
7.3.1 315,268 12/13/2017
7.3.0 87,889 12/13/2017
7.3.0-beta3 27,819 12/8/2017
7.3.0-beta2 44,902 11/20/2017
7.3.0-beta1 24,784 11/11/2017
7.2.1 2,662,953 10/24/2017
7.2.0 781,300 10/5/2017
7.2.0-beta3 41,122 9/5/2017
7.2.0-beta2 26,974 8/22/2017
7.2.0-beta1 23,246 8/19/2017
7.1.1 1,890,971 7/25/2017
7.1.0 533,014 6/28/2017
7.1.0-beta1 23,020 6/24/2017
7.0.3 725,188 6/7/2017
7.0.2 273,898 5/26/2017
7.0.1 79,047 5/23/2017
7.0.0 580,833 5/19/2017
7.0.0-beta3 27,538 5/1/2017
7.0.0-beta2 26,689 4/17/2017
7.0.0-beta1 24,255 4/7/2017
6.4.1 1,632,239 3/15/2017
6.4.1-beta1 23,385 3/13/2017
6.4.0 864,135 3/3/2017
6.4.0-rc4 145,931 2/13/2017
6.4.0-rc3 38,893 2/3/2017
6.4.0-rc2 39,354 1/30/2017
6.4.0-rc1 23,146 1/30/2017
6.4.0-beta9 90,225 11/21/2016
6.4.0-beta8 50,130 10/31/2016
6.4.0-beta7 23,765 10/28/2016
6.4.0-beta6 24,066 10/25/2016
6.4.0-beta5 23,702 10/24/2016
6.4.0-beta4 23,805 10/21/2016
6.4.0-beta3 70,424 7/4/2016
6.4.0-beta2 24,681 7/1/2016
6.4.0-beta10 22,902 1/30/2017
6.4.0-beta1 27,953 6/28/2016
6.3.4-alpha 397,000 6/1/2016
6.3.3-alpha 22,718 5/27/2016
6.2.1 4,776,112 2/26/2016
6.2.1-beta1 28,107 2/24/2016
6.2.0 156,277 2/22/2016
6.2.0-beta1 23,951 2/12/2016
6.1.0 395,210 1/18/2016
6.0.2 110,858 1/5/2016
6.0.1 38,526 1/5/2016
6.0.0 121,520 12/22/2015
5.6.2 1,395,475 5/29/2015
5.6.1 33,564 5/29/2015
5.5.0 1,106,281 10/31/2014
5.4.0 572,396 7/3/2014
5.3.0 100,938 5/27/2014
5.2.0 72,785 5/21/2014
5.1.0 925,185 3/11/2014
5.0.0.1 462,050 10/24/2013
4.0.0.1 276,966 7/18/2013
4.0.0 108,285 4/29/2013
3.4.6 382,286 8/30/2012
3.4.0 64,502 8/17/2012
3.3.1 80,488 3/30/2012
3.2.0 71,131 11/14/2011
3.1.0 52,144 7/30/2011
3.0.0.1 25,830 7/5/2011
3.0.0 41,598 6/25/2011
2.0.0 67,994 1/9/2011
1.3.0 195,427 1/7/2011

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