在 C# 中如何检查参数是否为 null

前言

前不久,微软宣布从 C# 11 中移除参数空值检查功能,该功能允许在方法开始执行之前,在参数名称的末尾提供参数空值检查(!!操作符)。.

在 C# 中如何检查参数是否为 null

那么,在 C# 中如何检查参数是否为 null 呢?

1. == null

这个可能是大家第一个就会想到的方法。

使用相等运算符符检查两个操作符是否相等:

if(user == null)
    throw new ArgumentNullException(nameof(user)); 

但是,==运算符可以被重载,可能导致检查空值的结果和预想的不一致:

public class User
{
    ...

    public static bool operator ==(User user1, User user2)
    {
        return false;
    }
}

var user = null;
if(user == null) // false
    throw new ArgumentNullException(nameof(user)); 

这时,可以使用is运算符。

2. is null

is运算符检查表达式的结果是否与给定的类型相匹配。将表达式与 null 匹配时,编译器保证不会调用用户重载的==运算符:

public class User
{
    ...

    public static bool operator ==(User user1, User user2)
    {
        return false;
    }
}

var user = null;
if(user is null) // true
    throw new ArgumentNullException(nameof(user)); 

3. 模式匹配

“模式匹配”是一种测试表达式是否具有特定特征的方法。模式匹配最常见的方案之一是确保值不是 null:

int? maybe = 12;

if (maybe is int number)
{
    Console.WriteLine($"The nullable int 'maybe' has the value {number}");
}
else
{
    Console.WriteLine("The nullable int 'maybe' doesn't hold a value");
}

但是,对于检查空值功能来说,这种方式可读性较差。

4. ArgumentNullException.ThrowIfNull

如果你使用的是 C# 10,建议你使用ArgumentNullException.ThrowIfNull方法检查空值:

ArgumentNullException.ThrowIfNull(user);

使用该方法的好处之一是在异常消息中会自动包含参数名称。

方法详细介绍可参看《.NET 6新特性试用 | ArgumentNullException卫语句》

结论

你是否还知道其他检查空值的方法,欢迎留言讨论。