跳转至

17. 命名区域

本章介绍命名区域(definedNames)的读回与写出保留。

Warning

命名区域支持范围:xlsx / xlsm 完整读回(workbook.xml 的 definedNames);xlsb 支持读回(BrtDefinedName + BrtExternSheet,简单单元格/区域引用,复杂表达式跳过);xls 支持简单单元格/区域引用(PtgRef3d / PtgArea3d),复杂公式类命名区域会跳过。xlsb / xls 写出均不支持命名区域。写出到不支持该能力的格式时命名区域会静默丢失,经 OnDegradation 上报。


17.1 读回命名区域

打开含命名区域的文件后,Workbook.Names 自动填充(全局 + sheet-local),遍历即可打印:

var opened = Excel.Open("names.xlsx");
foreach (var nr in opened.Names)
    Console.WriteLine($"{nr.Name} = {nr.Reference} local={nr.LocalSheetId}");

NamedRange 成员:Name、Reference(如 Sheet1!$A$1:$C$9)、LocalSheetId(-1 表示全局名称)、IsLocalSheet。

输出:

MyRange = Sheet1!$A$1:$C$9 local=-1
LocalRange = Sheet1!$B$2 local=0

xls 文件同样支持(简单单元格/区域引用读回),示例:Excel.Open("names.xls")。Workbook.Names 的填充逻辑对 xlsx/xlsm/xls 一致。

17.2 写出保留

命名区域在打开后保存时原样保留(xlsx/xlsm 走 workbook.xml 的 definedNames 透传),不会因编辑丢失:

var opened = Excel.Open("names.xlsx");
opened.Worksheets[0].SetValue("A1", "edited");
opened.Save();   // 命名区域仍保留

⚠️ 保存到 xls 时命名区域不会写回(xls 写回未实现);xlsx/xlsm 保存透传保留。

输出:已写入 names.xlsx