.NET 6中ArgumentNullException.ThrowIfNull()替换参数检查的适用场景咨询

核心结论 #

只有纯空值检查的场景才能安全用ArgumentNullException.ThrowIfNull()替换原有代码，带额外校验逻辑（如字符串空/空白、整数非正、集合为空等）的场景无法直接替换，必须保留或补充原有校验逻辑。

不同参数类型的适用情况 #

• 普通引用类型（非字符串、非集合）
  比如自定义类实例、接口对象等，只要原有代码仅做null判断，直接替换即可。
  原有代码：

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

  替换后：

  ArgumentNullException.ThrowIfNull(userService);
  

  完全符合CA2208规则，无需额外处理。

• 字符串类型
  仅当原有逻辑只检查null时可替换；若同时检查空字符串（""）或空白字符串（" "），必须保留额外校验：

  ArgumentNullException.ThrowIfNull(username);
  if (string.IsNullOrWhiteSpace(username))
      throw new ArgumentException("用户名不能为空或空白", nameof(username));
  

  注意：ThrowIfNull不会处理非null的空/空白字符串，这部分逻辑不能省略。

• 值类型与可空值类型

  • 普通值类型（如int、bool）本身不会为null，无需使用ThrowIfNull。
  • 可空值类型（如int?、DateTime?）仅检查null时可替换，但若需校验值的范围（如num <= 0），需在ThrowIfNull后补充逻辑：

    ArgumentNullException.ThrowIfNull(orderId);
    if (orderId <= 0)
        throw new ArgumentOutOfRangeException(nameof(orderId), "订单ID必须大于0");
    

• 集合类型（List、IEnumerable等）
  仅检查集合对象是否为null时可替换；若需校验集合是否为空（无元素），需单独处理：

  ArgumentNullException.ThrowIfNull(productList);
  if (!productList.Any())
      throw new ArgumentException("产品列表不能为空集合", nameof(productList));
  

  注意：集合为null和集合为空是两个不同的校验场景，ThrowIfNull只覆盖前者。

关于CA2208规则的处理 #

ArgumentNullException.ThrowIfNull()本身已经正确传递了参数名，完全符合CA2208的要求，所以纯空值检查场景替换后直接满足规则。但涉及额外校验的场景（如字符串空/空白、整数非正），仍需手动保证ArgumentException系列异常的参数名传递正确，这部分无法通过ThrowIfNull简化，只能按规则修正。

内容的提问来源于stack exchange，提问作者spankmaster79