C# 9.0 新特性預覽 - 空參數校驗

C# 9.0 新特性預覽 - 空參數校驗

前言
隨着 .NET 5 發佈日期的日益臨近，其對應的 C# 新版本已確定爲 C# 9.0，其中新增加的特性（或語法糖）也已基本鎖定，本系列文章將向大家展示它們。

目錄
[C# 9.0 新特性預覽 - 類型推導的 new]
[C# 9.0 新特性預覽 - 空參數校驗]
[C# 9.0 新特性預覽 - Lambda 中的棄元]
[C# 9.0 新特性預覽 - Record 類型]
[C# 9.0 新特性預覽 - 模式匹配的改善]
[C# 9.0 新特性預覽 - 其他小的變化]

簡便的空參數校驗 (Simplified Null Argument Checking)
目的
這個特性主要是爲了更簡便的檢查方法的參數是否爲 null 並拋出 ArgumentNullExceptiony 異常。

語法
語法很簡單，在參數名後加個歎號即可：

void M(string name!) {

...

}
以上代碼會被翻譯爲：

void M(string name) {

if (name is null) {
    throw new ArgumentNullException(nameof(name));
}
...

}
想必有些同學已經從上面代碼看出來了，這個生成的空校驗，只是校驗參數是否爲 null，這也就意味着它無法在值類型上使用，以下代碼將報錯：

// Error: 無法在值類型參數上使用!操作符
void G(T arg!) where T : struct {

}
當然，可空的值類型是可以的，但是編譯器會提示一條警告，提示你在可空類型上進行了空檢查：

// Warning: 將顯式null檢查與可爲null的類型結合使用
void M(int? x!) {
}
類似的，在參數擁有默認值的情況下，也會提示警告

// Warning: 參數 'x' 進行了空檢查但是它默認爲空
void M(string x! = null) {
}

構造方法的場景
在構造方法的場景下，空參數校驗將發生在任何其他代碼的前面，包括：

對其他構造方法的鏈式調用，即 this() 或 base()
在構造方法內的隱式字段初始化
舉個例子：

class C {

string field = GetString();
C(string name!): this(name) {
    ...
}

}
以上代碼會大致翻譯爲以下僞代碼：

class C {

C(string name)
    if (name is null) {
        throw new ArgumentNullException(nameof(name));
    }
    field = GetString();
    :this(name);
    ...

}

Lambda 的場景
這個特性在 lambda 中也可以使用

void G() {

Func<string, string> s = x! => x;

}

不可以使用的場景
這個特性只能用於有方法體的方法中，也就意味着它不能用於抽象方法、接口、委託和部分方法。
以下代碼編譯器會報錯：

interface C
{

public int M(string x!);// ERROR

}
不能用於屬性。因爲屬性 setter 中的 value 是隱式的，不會出現在參數列表中，所以此特性不適用於屬性。

string FirstName! { get; set; } // ERROR
不能用於 out / ref / in 的參數

public void M(out string x!) {} // ERROR

參考
[Proposal: Simplified Null Argument Checking]
[Unit test: NullCheckedParameterTests.cs]
[LDM-2019-07-10.md]

原文地址https://www.cnblogs.com/Rwing/p/csharp-9-0-preview-null-arg-checking.html