Installation

Install the package via NuGet Package Manager:

Or via the Package Manager Console:

Usage

Import the namespace in your code:

Then use the validation methods just as you would with native .NET implementations:

Available Methods

Null Validation

Argument.ThrowIfNull(object?, string?)

Throws an ArgumentNullException if the argument is null.

Replacement for: ArgumentNullException.ThrowIfNull(object, string) (introduced in .NET 6)

Example:

Argument.ThrowIfNull(void*, string?)

Throws an ArgumentNullException if the pointer argument is null.

Replacement for: ArgumentNullException.ThrowIfNull(void*, string) (introduced in .NET 7)

Argument.ThrowIfNullOrEmpty(string?, string?)

Throws an ArgumentNullException if the argument is null, or an ArgumentException if the argument is an empty string.

Replacement for: ArgumentException.ThrowIfNullOrEmpty(string, string) (introduced in .NET 7)

Example:

Argument.ThrowIfNullOrEmpty<T>(IEnumerable<T>?, string?)

Throws an ArgumentNullException if the argument is null, or an ArgumentException if the collection is empty.

Note: This is a custom extension method not present in the base .NET framework, providing convenient collection validation.

Example:

Argument.ThrowIfNullOrWhiteSpace(string?, string?)

Throws an ArgumentNullException if the argument is null, or an ArgumentException if the argument is empty or contains only white-space characters.

Replacement for: ArgumentException.ThrowIfNullOrWhiteSpace(string, string) (introduced in .NET 8)

Example:

Range Validation

Argument.ThrowIfEqual<T>(T, T, string?)

Throws an ArgumentOutOfRangeException if the first argument is equal to the second argument.

Replacement for: ArgumentOutOfRangeException.ThrowIfEqual<T>(T, T, string) (introduced in .NET 8)

Example:

Argument.ThrowIfNotEqual<T>(T, T, string?)

Throws an ArgumentOutOfRangeException if the first argument is not equal to the second argument.

Replacement for: ArgumentOutOfRangeException.ThrowIfNotEqual<T>(T, T, string) (introduced in .NET 8)

Argument.ThrowIfGreaterThan<T>(T, T, string?)

Throws an ArgumentOutOfRangeException if the first argument is greater than the second argument.

Replacement for: ArgumentOutOfRangeException.ThrowIfGreaterThan<T>(T, T, string) (introduced in .NET 8)

Example:

Argument.ThrowIfGreaterThanOrEqual<T>(T, T, string?)

Throws an ArgumentOutOfRangeException if the first argument is greater than or equal to the second argument.

Replacement for: ArgumentOutOfRangeException.ThrowIfGreaterThanOrEqual<T>(T, T, string) (introduced in .NET 8)

Example:

Argument.ThrowIfLessThan<T>(T, T, string?)

Throws an ArgumentOutOfRangeException if the first argument is less than the second argument.

Replacement for: ArgumentOutOfRangeException.ThrowIfLessThan<T>(T, T, string) (introduced in .NET 8)

Example:

Argument.ThrowIfLessThanOrEqual<T>(T, T, string?)

Throws an ArgumentOutOfRangeException if the first argument is less than or equal to the second argument.

Replacement for: ArgumentOutOfRangeException.ThrowIfLessThanOrEqual<T>(T, T, string) (introduced in .NET 8)

Example:

Framework Compatibility

Contributing

Contributions are welcome! Please feel free to submit issues, fork the repository, and create pull requests.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Related Resources

• Official .NET API Documentation
• Argument Validation Best Practices
• Project Repository