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);
输出:
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);
输出:
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 格式读取入口:
输出:
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());
输出: