WeihanLi.Npoi 1.14.0 Release Notes
Intro
周末更新了一下專案，開始使用可空參考型別，并且移除了 net45 的支持，僅支持 netstandard2.0
Changes
Remove net45 Support
基礎庫打算移除 net45 的支持，因為很多基礎的API，在 netstandard2.0 中是有的，但是 net45 是沒有的，比如 Array.Empty/Task.CompletedResult 等，所以很多時候需要為 net45 專門寫一些代碼來實作類似的功能，而且隨著 .NET Core 的開發者越來越多，.NET Core 越來越成熟，所以打算拋棄 net45 也可以使得維護更為方便和簡單，
Nullable Reference
新版本完全啟用了 Nullable Reference Types 可空參考型別，之所以啟用可空參考型別，一來是希望能夠為開發者們使用提供更好的體驗，開發者在開發的時候，就可以知道自己用到的 API 輸入引數是否允許為 null，如果不允許為 null 開發者可以在呼叫 API 之前檢查 null，避免輸入一個不期望的 null ，對于 API 的回傳值也會更加清晰，可以清晰地了解一個 API 的回傳值是否會為 null，如果會為 null 則可能需要做空檢查，如果不會為 null 就不需要做不必要的空檢查了，
Sample
提供了一個示例專案，示例專案是 dotnet core 3.1 的專案，并且專案并沒有啟用可空參考型別，下面是一段示例代碼：
var workbook = ExcelHelper.LoadExcel(excelPath:null);
if (workbook is null)
{
Console.WriteLine("workbook is null");
}
IWorkbook ExcelHelper.LoadExcel(string excelPath) 這個 API 的輸入引數期待的是一個不可空參考型別，回傳值是一個不為空的參考型別，雖然示例專案并沒有啟用可空參考型別，VS 也是會給出一些提示的，提示如下：
如果將一個 null 傳遞給一個是不可空參考型別的值會怎么樣呢，這取決于實作代碼的處理，在前面一篇文章我已經提到過了，期望輸入值是不可空參考型別時，依然需要做必要的空檢查，實際改造的時候我也是這么做的，如果不可空參考型別接收了一個 null 基本都會獲得一個 ArgumentNullException
上述代碼執行結果輸出如下：
More
從上面的示例可以看的出來，可空參考型別能夠為我們帶來很大的便利，而且也可以增加程式的健壯性，通過 VS 的提示，啟用可空型別可以將提示提升為 Warning 更好的提升代碼可靠性，也可以減少很多不必要的空檢查，通過啟用可空參考型別，也讓我修復了一些原本代碼中缺少的檢查，進一步增強了代碼的健壯性，
示例代碼可以從 https://github.com/WeihanLi/SamplesInPractice/blob/master/NPOISample/NPOIExtensionSample.cs 獲取，可以自行測驗
References
- https://docs.microsoft.com/en-us/dotnet/csharp/nullable-references
- https://docs.microsoft.com/en-us/dotnet/csharp/tutorials/upgrade-to-nullable-references
- https://docs.microsoft.com/en-us/dotnet/csharp/nullable-migration-strategies
- https://github.com/dotnet/aspnetcore/issues/5680
- https://github.com/WeihanLi/WeihanLi.Npoi/pull/98
- https://www.nuget.org/packages/WeihanLi.Npoi/1.14.0
- https://github.com/WeihanLi/SamplesInPractice/blob/master/NPOISample/NPOIExtensionSample.cs
轉載請註明出處，本文鏈接：https://www.uj5u.com/net/251294.html
標籤：.NET技术