跳转至

23. AOT 兼容性

本章介绍 Native AOT / 裁剪兼容的保障与验证。


23.1 DAM 标注

List\<T> 反射映射 API 已用 [DynamicallyAccessedMembers] 标注,AOT / 裁剪安全:

  • Excel.Create<T> / Excel.Write<T> / Excel.Read<T> 标注 PublicProperties(读取还含 PublicParameterlessConstructor)。
  • Worksheet.ImportData<T> / WorksheetCollection.Add<T> 标注 PublicProperties。
  • XlsxReader.Read<T> / XlsxWriter.Write<T> 同样标注(见附录 B.2 / B.3)。

以第 5 章的 Person 为例(映射无需额外配置,公开属性由库内标注保留):

var people = new List<Person> { new() { Name = "张三", Age = 30 } };
Excel.Write("people.xlsx", people);

var read = Excel.Read<Person>("people.xlsx");
Console.WriteLine(read.Count);

输出:

1

23.2 IsAotCompatible

net8.0 目标在 csproj 声明 IsAotCompatible=true,全部公开 API 兼容 Native AOT / 裁剪:

var wb = Excel.Create("Sheet1");
wb.Worksheets["Sheet1"].SetValue("A1", "x");
Excel.Write("aot.xlsx", wb);

var reopened = Excel.Open("aot.xlsx");
Console.WriteLine(reopened.Worksheets.Count);

输出:

1

23.3 验证方式与成果摘要

  • 经原生 AOT 可执行文件实测,全部公开 API 通过。
  • AOT 零 IL 警告 + 运行期断言通过。
  • 注意:Excel.Read<T> / XlsxReader.Read(见附录 B.2)仅支持 xlsx / xlsm;xls / xlsb / csv 必须走 Excel.Open(path)(按扩展名路由后端)。按需读表名时用 Excel.Open 处理非 zip 格式。

非 zip 格式读取入口:

var wb = Excel.Open("data.xls");
Console.WriteLine(string.Join(",", wb.Worksheets.Names));

输出:

Sheet1

23.4 InvariantGlobalization

全局不变量(常见于 AOT / 容器):

  • 发布时加 <InvariantGlobalization>true</InvariantGlobalization> 不会影响本库任何功能;读取侧 Encoding.GetEncoding 与写入侧 CultureInfo.InvariantCulture 均通过验证。
  • 前提:基准日期边界(1900/1904 日期系统)与 xls ANSI 字符串需走 Latin1,非当前系统代码页的字符可能失真。这是 BIFF8 的固有限制,与 AOT 无关。

不变量下日期写出 / 读回(固定 yyyy-MM-dd 数字格式):

var wb = Excel.Create();
wb.Worksheets["Sheet1"].SetValue("A1", new DateTime(2024, 1, 2));
Excel.Write("inv.csv", wb);

var reopened = Excel.Open("inv.csv");
var data = reopened.Worksheets[0].ToSheetData();
Console.WriteLine(data.Rows[0][0].GetString());

输出:

2024-01-02