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 是没有的，所以很多时候需要为 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 更好的提升代码可靠性，也可以减少很多不必要的空检查，通过启用可空引用类型，也让我修复了一些原本代码中缺少的检查，进一步增强了代码的健壮性。

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