WeihanLi.Npoi 1.14.0 Release Notes

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 也是会给出一些提示的,提示如下:

WeihanLi.Npoi 1.14.0 Release Notes

WeihanLi.Npoi 1.14.0 Release Notes

如果将一个 null 传递给一个是不可空引用类型的值会怎么样呢,这取决于实现代码的处理,在前面一篇文章我已经提到过了,期望输入值是不可空引用类型时,依然需要做必要的空检查,实际改造的时候我也是这么做的,如果不可空引用类型接收了一个 null 基本都会获得一个 ArgumentNullException

上述代码执行结果输出如下:

WeihanLi.Npoi 1.14.0 Release Notes

More

从上面的示例可以看的出来,可空引用类型能够为我们带来很大的便利,而且也可以增加程序的健壮性,通过 VS 的提示,启用可空类型可以将提示提升为 Warning 更好的提升代码可靠性,也可以减少很多不必要的空检查,通过启用可空引用类型,也让我修复了一些原本代码中缺少的检查,进一步增强了代码的健壮性。

示例代码可以从 https://github.com/WeihanLi/SamplesInPractice/blob/master/NPOISample/NPOIExtensionSample.cs 获取,可以自行测试

References

发表评论

评论已关闭。

相关文章