.NET 6新特性试用 | ArgumentNullException卫语句
前言
在前面的文章中(《可空引用類型》),我們介紹過編譯器會幫我們檢查空引用,但是僅僅是警告。最好的方式還是在運行時用衛語句進行檢查:
private?void?Test(WeatherForecast?weatherForecast) {if?(weatherForecast?==?null){?throw?new?ArgumentNullException(nameof(weatherForecast));} }在.NET 6中,在ArgumentNullException類中添加了一個名為ThrowIfNull的新靜態方法,它允許我們快速檢查和拋出 ArgumentNullExceptions:
有意思的是,異常信息自動帶出了參數名稱,這樣可以有效避免使用nameof用錯參數。
那這是怎么做到的呢?
原理探究
查看ThrowIfNull的定義,可以看到還有一個默認參數,使用了CallerArgumentExpression屬性聲明:
public?static?void?ThrowIfNull([NotNull]?object??argument,?[CallerArgumentExpression("argument")]?string??paramName?=?null)在編譯時,編譯器會把上面的代碼編譯成如下形式,傳入了參數名:
ArgumentNullException.ThrowIfNull(weatherForecast,?"weatherForecast");原理利用
很可惜,.NET 6沒有提供更多類似ThrowIfNull的幫助方法,但是我們可以利用CallerArgumentExpression實現自己的幫助類來簡化衛語句。
比如:
public?class?ArgumentExceptionHelper?{public?static?void?ThrowIfNullOrEmpty(string??argument,?[CallerArgumentExpression("argument")]?string??paramName?=?null){if(string.IsNullOrEmpty(?argument))throw?new?ArgumentNullException(paramName);}public?static?void?ThrowIfOutOfRange(bool?argument,?[CallerArgumentExpression("argument")]?string??paramName?=?null){if?(argument)throw?new?ArgumentOutOfRangeException(paramName);} }//使用 ArgumentExceptionHelper.ThrowIfNullOrEmpty(name);ArgumentExceptionHelper.ThrowIfOutOfRange(age?<=?0);最為奇妙的是,CallerArgumentExpression的功能是表示一個參數將傳遞給另一個參數的表達式作為字符串捕獲。,錯誤提示的不是參數名稱,而是實際傳入的表達式,因此更清晰。
例如下面的錯誤提示Age<=0:
結論
在.NET 6之前,.NET中已有三個[Caller*]屬性可用:
[CallerMemberName]
[CallerFilePath]
[CallerLineNumber]
詳細介紹請參看:https://docs.microsoft.com/en-us/dotnet/api/system.runtime.compilerservices.callermembernameattribute
利用這些屬性,可以讓編譯器“神奇地”填充它們,幫助我們輕松獲取調用者信息。
如果你覺得這篇文章對你有所啟發,請幫忙點個贊或者在看
總結
以上是生活随笔為你收集整理的.NET 6新特性试用 | ArgumentNullException卫语句的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 如何修改 asp.net core 5
- 下一篇: asp.net ajax控件工具集 Au