CKTIS / C#
System.ArgumentNullException: practical reference
System.ArgumentNullException: practical reference: ArgumentNullException specializes the error for a required argument that is null; ThrowIfNull retains the expression name.
Version: .NET API; verified on .NET 10.0.14
Syntax
System.ArgumentNullException /* select a documented member or constructor */ArgumentNullException specializes the error for a required argument that is null; ThrowIfNull retains the expression name.
Use it to enforce required references immediately at a method entry.
Do not catch the exception merely to continue with an absent value; fix the caller contract.
An explicit cast may be needed with the object and void* overloads; ParamName can be supplied manually.
The complete program actually uses System.ArgumentNullException; its exact expected stdout is input.
Examples
using System;
using System.Buffers;
using System.Collections.Concurrent;
using System.Collections.Frozen;
using System.Collections.Generic;
using System.Collections.Immutable;
using System.Diagnostics;
using System.Globalization;
using System.IO;
using System.Linq;
using System.Linq.Expressions;
using System.Reflection;
using System.Runtime.CompilerServices;
using System.Runtime.InteropServices;
using System.Text;
using System.Text.Json;
using System.Text.Json.Nodes;
using System.Text.Json.Serialization;
using System.Text.RegularExpressions;
using System.Threading;
using System.Threading.Channels;
using System.Threading.Tasks;
using Number = System.Int32;
try { ArgumentNullException.ThrowIfNull((object?)null, "input"); } catch (ArgumentNullException error) { Console.WriteLine(error.ParamName); }
Result
input
The complete program actually uses `System.ArgumentNullException`; its exact expected stdout is `input`.