[API Proposal]: ArgumentException.ThrowIfNullOrEmpty(string)

[datvm]

Background and motivation

Inspired by ArgumentNullException.ThrowIfNull(object). string.IsNullOrEmpty(text) is a frequent check especially in web/Console project. At first I thought InvalidDataException would be the best name but it is in System.IO namespace, so I think the closest should be ArgumentException so user doesn't need to import that namespace.

Now:

if (string.IsNullOrEmpty(input)) { throw new ArgumentException($"{nameof(input)} must contain value."); }

If the API is approved:

ArgumentException.ThrowIfNullOrEmpty(input);

While we are at it, personally I rarely use it but maybe ThrowIfNullOrWhiteSpace may be useful for others as well?

API Proposal

namespace System
{
    public class ArgumentException : SystemException
    {
        public static void ThrowIfNullOrEmpty([NotNull] string? argument, [CallerArgumentExpression("argument")] string? paramName = null)
    }
}

API Usage

ArgumentException.ThrowIfNullOrEmpty(input);

Alternative Designs

No response

Risks

No response

I couldn't figure out the best area label to add to this issue. If you have write-permissions please help me learn by adding exactly one area label.

Tagging subscribers to this area: @dotnet/area-system-runtime
See info in area-owners.md if you want to be subscribed.

Issue Details

---

Background and motivation

Inspired by ArgumentNullException.ThrowIfNull(object). string.IsNullOrEmpty(text) is a frequent check especially in web/Console project. At first I thought InvalidDataException would be the best name but it is in System.IO namespace, so I think the closest should be ArgumentException so user doesn't need to import that namespace.

Now:

if (string.IsNullOrEmpty(input)) { throw new ArgumentException($"{nameof(input)} must contain value."); }

If the API is approved:

ArgumentException.ThrowIfNullOrEmpty(input);

While we are at it, personally I rarely use it but maybe ThrowIfNullOrWhiteSpace may be useful for others as well?

API Proposal

namespace System
{
    public class ArgumentException : SystemException
    {
        public static void ThrowIfNullOrEmpty([NotNull] string argument, [CallerArgumentExpression("argument")] string? paramName = null)
    }
}

API Usage

ArgumentException.ThrowIfNullOrEmpty(input);

Alternative Designs

No response

Risks

No response

Author:	datvm
Assignees:	-
Labels:	api-suggestion, area-System.Runtime, untriaged
Milestone:	-

[Clockwork-Muse]

[NotNull]

... but the parameter can be null, since that's the point of the exception?

[stephentoub]

The argument to the existing ThrowIfNull is declared as:

[NotNull] object? argument

which uses ? to avoid warnings when being used with something that may be null, but then [NotNull] to say "upon successful return from this method, it's guaranteed argument isn't null."

[danmoseley]

Makes sense to me. It would collapse stuff like

runtime/src/libraries/System.Private.CoreLib/src/System/Threading/Mutex.Windows.cs

Lines 44 to 52 in dfbae37

	if (name == null)
	{
	throw new ArgumentNullException(nameof(name));
	}
	if (name.Length == 0)
	{
	throw new ArgumentException(SR.Argument_EmptyName, nameof(name));
	}

from 10 lines to 1.

In that example, it has a custom message, ie "Empty name is not legal.", and using this proposed API would change that to something generic. I think that's totally fine. There are cases where perhaps the message adds slightly more value eg "Empty file name is not legal." and perhaps those would not change to use this API, which is fine.

[hrrrrustic]

Maybe it would also make sense to add overload with IReadOnlyCollection<T> or simply ICollection<T>?

public static void ThrowIfNullOrEmpty<T>([NotNull] I/*ReadOnly*/Collection<T> argument, [CallerArgumentExpression("argument")] string? paramName = null);

Usages:

runtime/src/libraries/System.Diagnostics.EventLog/src/System/Diagnostics/EventLog.cs

Lines 264 to 265 in 895c99c

	if (source == null || source.Length == 0)
	throw new ArgumentException(SR.Format(SR.MissingParameter, nameof(source)));

runtime/src/libraries/System.Security.Cryptography.X509Certificates/src/System/Security/Cryptography/X509Certificates/X509Certificate.cs

Lines 84 to 85 in 895c99c

	if (rawData == null || rawData.Length == 0)
	throw new ArgumentException(SR.Arg_EmptyOrNullArray, nameof(rawData));

Didn't try to find splitted if-checks

Makes sense to me. It would collapse stuff like

runtime/src/libraries/System.Private.CoreLib/src/System/Threading/Mutex.Windows.cs

Lines 44 to 52 in dfbae37

	if (name == null)
	{
	throw new ArgumentNullException(nameof(name));
	}
	if (name.Length == 0)
	{
	throw new ArgumentException(SR.Argument_EmptyName, nameof(name));
	}

from 10 lines to 1.

In that example, it has a custom message, ie "Empty name is not legal.", and using this proposed API would change that to something generic. I think that's totally fine. There are cases where perhaps the message adds slightly more value eg "Empty file name is not legal." and perhaps those would not change to use this API, which is fine.

[Rubenisme]

If this is done, then after that I'm sure someone will ask: "What about an ArgumentException.ThrowIfNullOrWhiteSpace?".
I think the string.IsNullOrWhiteSpace method gets used a lot less than the string.IsNullOrEmpty method, so might not be as useful.

[terrajobst]

Video

• Looks good as proposed
  • Might be good to do a pass what ArgumentOutOfRangeException cases we use internally. We could base it off the unique resource strings we use in corlib.
• The API should
  • Throw ArgumentNullException if argument is null, otherwise ArgumentException
• We don't believe we need an overload of ThrowIfNullOrEmpty for collections as this feels rare.

namespace System
{
    public partial class ArgumentException
    {
        public static void ThrowIfNullOrEmpty([NotNull] string? argument,
                                              [CallerArgumentExpression("argument")] string? paramName = null);
    }
}