https://github.com/nogic1008/throwhelperextensions
Use ThrowHelper methods (ex. `ArgumentException.ThrowIfNull`) on your elderly .NET project
https://github.com/nogic1008/throwhelperextensions
csharp dotnet throw
Last synced: about 2 months ago
JSON representation
Use ThrowHelper methods (ex. `ArgumentException.ThrowIfNull`) on your elderly .NET project
- Host: GitHub
- URL: https://github.com/nogic1008/throwhelperextensions
- Owner: nogic1008
- License: mit
- Created: 2025-05-13T14:13:26.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2026-02-10T04:54:33.000Z (3 months ago)
- Last Synced: 2026-02-10T09:48:07.752Z (3 months ago)
- Topics: csharp, dotnet, throw
- Language: C#
- Homepage:
- Size: 85.9 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ThrowHelperExtensions
[](https://www.nuget.org/packages/Nogic.ThrowHelperExtensions/)
[](https://github.com/nogic1008/ThrowHelperExtensions/releases)
[](https://github.com/nogic1008/ThrowHelperExtensions/actions/workflows/dotnet-ci.yml)
[](https://codecov.io/gh/nogic1008/ThrowHelperExtensions)
[](https://www.codefactor.io/repository/github/nogic1008/ThrowHelperExtensions)
[](LICENSE)
Use ThrowHelper methods (ex. `ArgumentException.ThrowIfNull`) on your elderly .NET project
## Usage
### 1. Set `LangVersion` to C# 14
This package uses [Extension members](https://learn.microsoft.com/dotnet/csharp/whats-new/csharp-14#extension-members) feature on C# 14.
Please Add below on your `.csproj` or `Directory.Build.props`.
```xml
14
```
### 2. Add Package
```console
dotnet add package Nogic.ThrowHelperExtensions
```
### 3. Use throw helpers
```csharp
namespace Samples;
public class Sample
{
public string Value1 { get; }
public Sample(string value1)
{
// On .NET 6.0 or higher, it calls `ArgumentNullException.ThrowIfNull` directly.
// On others, it calls `System.ExceptionPolyfills.ThrowIfNull` polyfill via extension members.
ArgumentNullException.ThrowIfNull(value1);
this.Value1 = value1;
}
}
```
## API
- [`ArgumentException.ThrowIfNullOrEmpty(string?, string?)`](https://learn.microsoft.com/dotnet/api/system.argumentexception.throwifnullorempty?view=net-7.0)
- [`ArgumentException.ThrowIfNullOrWhiteSpace(string?, string?)`](https://learn.microsoft.com/dotnet/api/system.argumentexception.throwifnullorwhitespace?view=net-8.0)
- [`ArgumentNullException.ThrowIfNull(object?, string?)`](https://learn.microsoft.com/dotnet/api/system.argumentnullexception.throwifnull?view=net-6.0#System_ArgumentNullException_ThrowIfNull_System_Object_System_String_)
- [`ArgumentNullException.ThrowIfNull(void*, string?)`](https://learn.microsoft.com/dotnet/api/system.argumentnullexception.throwifnull?view=net-7.0#system-argumentnullexception-throwifnull(system-void*-system-string))
- Set `AllowUnsafeBlocks` to `true` in your project file to use this overload.
- [`ObjectDisposedException.ThrowIf(bool, object)`](https://learn.microsoft.com/dotnet/api/system.objectdisposedexception.throwif?view=net-7.0#system-objectdisposedexception-throwif(system-boolean-system-object))
- [`ObjectDisposedException.ThrowIf(bool, Type)`](https://learn.microsoft.com/dotnet/api/system.objectdisposedexception.throwif?view=net-7.0#system-objectdisposedexception-throwif(system-boolean-system-type))
- [`ArgumentOutOfRangeException.ThrowIfEqual(T, T, string?)`](https://learn.microsoft.com/dotnet/api/system.argumentoutofrangeexception.throwifequal?view=net-10.0)
- [`ArgumentOutOfRangeException.ThrowIfGreaterThan(T, T, string?) where T : IComparable`](https://learn.microsoft.com/dotnet/api/system.argumentoutofrangeexception.throwifgreaterthan?view=net-8.0)
- [`ArgumentOutOfRangeException.ThrowIfGreaterThanOrEqual(T, T, string?) where T : IComparable`](https://learn.microsoft.com/dotnet/api/system.argumentoutofrangeexception.throwifgreaterthanorequal?view=net-8.0)
- [`ArgumentOutOfRangeException.ThrowIfLessThan(T, T, string?) where T : IComparable`](https://learn.microsoft.com/dotnet/api/system.argumentoutofrangeexception.throwiflessthan?view=net-8.0)
- [`ArgumentOutOfRangeException.ThrowIfLessThanOrEqual(T, T, string?) where T : IComparable`](https://learn.microsoft.com/dotnet/api/system.argumentoutofrangeexception.throwiflessthanorequal?view=net-8.0)
- [`ArgumentOutOfRangeException.ThrowIfNegative(T, string?) where T : INumberBase`](https://learn.microsoft.com/dotnet/api/system.argumentoutofrangeexception.throwifnegative?view=net-8.0) [^1]
- [`ArgumentOutOfRangeException.ThrowIfNegativeOrZero(T, string?) where T : INumberBase`](https://learn.microsoft.com/dotnet/api/system.argumentoutofrangeexception.throwifnegativeorzero?view=net-8.0) [^1]
- [`ArgumentOutOfRangeException.ThrowIfNotEqual(T, T, string?)`](https://learn.microsoft.com/dotnet/api/system.argumentoutofrangeexception.throwifnotequal?view=net-10.0)
- [`ArgumentOutOfRangeException.ThrowIfZero(T, string?) where T : INumberBase`](https://learn.microsoft.com/dotnet/api/system.argumentoutofrangeexception.throwifzero?view=net-8.0) [^1]
[^1]: [`INumberBase`](https://learn.microsoft.com/dotnet/api/system.numerics.inumberbase-1?view=net-7.0) is not available in .NET 6.0 or below (including .NET Standard 2.0).
So, this method only has overloads for the built-in numeric types. (`byte`, `sbyte`, `short`, `ushort`, `int`, `uint`, `long`, `ulong`, `float`, `double`, `decimal`, `nint`, `nuint`, `char`)
### Limitations
- Except for `ArgumentNullException.ThrowIfNull`, exception messages are not localized.
- Unlike .NET 8.0 and 9.0, these methods do not have `IEquatable` constraint on type parameter `T`. (based on .NET 10.0+ source code)
- `ArgumentOutOfRangeException.ThrowIfEqual(T, T, string?)`
- `ArgumentOutOfRangeException.ThrowIfNotEqual(T, T, string?)`
- The generated class `System.ExceptionPolyfills` is `internal`.
## Options
### ThrowHelperExtensionsGenerateAttributes
By default, this generator will generate necessary attribute types. (ex. `DoesNotReturnAttribute`)
If you want to disable attribute generation (for example, use other generator like [PolySharp](https://www.nuget.org/packages/PolySharp/)), you can set the following MSBuild property in your project file:
```xml
false
```