Ensure.That 7.2.0

Argument validation made simple and unified. It ensures arguments conforms to simple validation rules and provides an uniformed exception throwing strategy if arguments are invalid.

There is a newer version of this package available.
See the version list below for details.
Install-Package Ensure.That -Version 7.2.0
dotnet add package Ensure.That --version 7.2.0
paket add Ensure.That --version 7.2.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Using contextual validation

This flavour was introduced in the v7.0.0 release.

Ensure.String.IsNotNullOrWhiteSpace(myString);
Ensure.String.IsNotNullOrWhiteSpace(myString, nameof(myArg));
Ensure.String.IsNotNullOrWhiteSpace(myString, nameof(myArg), opts => opts.WithMessage("Foo"));

the value is passed through so that you e.g. can assign it to a field:

_field1 = Ensure.String.IsNotNullOrWhiteSpace(myString);
_field2 = Ensure.String.IsNotNullOrWhiteSpace(myString, nameof(myArg));

Using static simple methods

The EnsureArg flavour was added in the v5.0.0 release.

EnsureArg.IsNotNullOrWhiteSpace(myString);
EnsureArg.IsNotNullOrWhiteSpace(myString, nameof(myArg));
EnsureArg.IsNotNullOrWhiteSpace(myString, nameof(myArg), opts => opts.WithMessage("Foo"));

the value is passed through so that you e.g. can assign it to a field:

_field1 = EnsureArg.IsNotNullOrWhiteSpace(myString);
_field2 = EnsureArg.IsNotNullOrWhiteSpace(myString, nameof(myArg));

Turn On/Off - default is On

Could be used with different profiles. Like Debug and CI is On while Release is Off.

#if RELEASE
    Ensure.Off()
#endif

Using contextual validation

This flavour was introduced in the v7.0.0 release.

Ensure.String.IsNotNullOrWhiteSpace(myString);
Ensure.String.IsNotNullOrWhiteSpace(myString, nameof(myArg));
Ensure.String.IsNotNullOrWhiteSpace(myString, nameof(myArg), opts => opts.WithMessage("Foo"));

the value is passed through so that you e.g. can assign it to a field:

_field1 = Ensure.String.IsNotNullOrWhiteSpace(myString);
_field2 = Ensure.String.IsNotNullOrWhiteSpace(myString, nameof(myArg));

Using static simple methods

The EnsureArg flavour was added in the v5.0.0 release.

EnsureArg.IsNotNullOrWhiteSpace(myString);
EnsureArg.IsNotNullOrWhiteSpace(myString, nameof(myArg));
EnsureArg.IsNotNullOrWhiteSpace(myString, nameof(myArg), opts => opts.WithMessage("Foo"));

the value is passed through so that you e.g. can assign it to a field:

_field1 = EnsureArg.IsNotNullOrWhiteSpace(myString);
_field2 = EnsureArg.IsNotNullOrWhiteSpace(myString, nameof(myArg));

Turn On/Off - default is On

Could be used with different profiles. Like Debug and CI is On while Release is Off.

#if RELEASE
    Ensure.Off()
#endif

Release Notes

https://github.com/danielwertheim/ensure.that/blob/master/ReleaseNotes.md

  • .NETFramework 4.5.1

    • No dependencies.
  • .NETStandard 1.1

  • .NETStandard 2.0

    • No dependencies.

Version History

Version Downloads Last updated
8.0.0 39,863 4/29/2018
8.0.0-pre78 186 2/17/2018
8.0.0-pre71 92 2/14/2018
7.2.1 35,445 12/29/2017
7.2.0 10,085 12/14/2017
7.1.0 9,980 11/19/2017
7.1.0-pre50 123 11/15/2017
7.0.0 2,067 11/9/2017
7.0.0-pre43 110 11/9/2017
7.0.0-pre38 110 11/9/2017
7.0.0-pre37 114 10/31/2017
7.0.0-pre32 1,353 10/16/2017
7.0.0-pre24 212 9/27/2017
6.0.1 6,405 10/4/2017
6.0.1-pre28 111 10/3/2017
6.0.0 5,054 9/19/2017
6.0.0-pre18 117 9/14/2017
6.0.0-pre16 132 9/10/2017
6.0.0-pre15 112 9/10/2017
6.0.0-pre12 110 9/9/2017
6.0.0-pre11 132 9/7/2017
5.0.0 119,606 10/8/2016
5.0.0-b3 193 10/5/2016
4.0.0 59,516 11/24/2015
3.3.0 1,218 11/10/2015
3.2.0 1,702 9/28/2015
3.1.1 644 9/19/2015
3.1.0 1,668 8/30/2015
3.0.0 944 8/22/2015
2.0.0 25,623 7/2/2014
1.0.0 4,091 7/10/2013