Ensure.That 7.2.1

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 prerelease version of this package available.
See the version list below for details.
Install-Package Ensure.That -Version 7.2.1
dotnet add package Ensure.That --version 7.2.1
paket add Ensure.That --version 7.2.1
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-pre78 108 2/17/2018
8.0.0-pre71 58 2/14/2018
7.2.1 (current version) 17,271 12/29/2017
7.2.0 3,993 12/14/2017
7.1.0 6,682 11/19/2017
7.1.0-pre50 93 11/15/2017
7.0.0 1,546 11/9/2017
7.0.0-pre43 76 11/9/2017
7.0.0-pre38 76 11/9/2017
7.0.0-pre37 81 10/31/2017
7.0.0-pre32 865 10/16/2017
7.0.0-pre24 162 9/27/2017
6.0.1 4,679 10/4/2017
6.0.1-pre28 81 10/3/2017
6.0.0 3,967 9/19/2017
6.0.0-pre18 88 9/14/2017
6.0.0-pre16 102 9/10/2017
6.0.0-pre15 83 9/10/2017
6.0.0-pre12 82 9/9/2017
6.0.0-pre11 98 9/7/2017
5.0.0 94,039 10/8/2016
5.0.0-b3 164 10/5/2016
4.0.0 45,478 11/24/2015
3.3.0 1,182 11/10/2015
3.2.0 1,583 9/28/2015
3.1.1 621 9/19/2015
3.1.0 1,626 8/30/2015
3.0.0 922 8/22/2015
2.0.0 24,602 7/2/2014
1.0.0 3,821 7/10/2013