# fsys.openXml.xlsx 库模块帮助文档 [» XLSX 读取](https://www.aardio.com/zh-cn/docs/library/fsys/openXml/xlsx/) [» 结构与日期](https://www.aardio.com/zh-cn/docs/library/fsys/openXml/xlsx/structure.html) [» 原生查询](https://www.aardio.com/zh-cn/docs/library/fsys/openXml/xlsx/query.html) ## fsys.openXml.xlsx 成员列表 # SpreadsheetML 保存值、结构、日期解释与有界查询；无 Office/WPS/.NET 依赖。支持 XLSX/XLSM/XLTX/XLTM/XLAM 的 XML 工作表，不解析 XLS/XLSB。不重算公式、不模拟 Excel 显示/布局引擎、不执行宏/外链、不修改源包。 ### fsys.openXml.xlsx.extractMedia(path,outputDir,options) # 媒体平铺导出，默认不覆盖；可选 overwrite,maxMedia 及包限额。返回 outputDir,files,skipped；失败 null,err,partial。同名预检，校验 CRC 后逐文件提交，不是整批事务。 ### fsys.openXml.xlsx.extractText(path,options) # 在 readWorkbook 结果及各成功页增加 text；TAB 分列、CRLF 分行，保留稀疏空格位。强制 includeRows=true，不重算公式或应用显示格式。 maxTextBytes 默认16777216、最高134217728，按展开后的 UTF-8 文本含分隔符计数，超限返回错误。 ### fsys.openXml.xlsx.findCells(path,sheet,options) # target=value/formula，op=eq/ne/gt/ge/lt/le/contains/in/isNull/isEmpty，value为标量或in数组。 range限定选区，maxScanCells=1000000/offset=0/limit=100；返回cells及扫描/匹配/截取信息。只查已存储c节点；公式正文不展开共享公式，无缓存也能查公式。 ### fsys.openXml.xlsx.inspectWorkbook(path,options) # 有界预览与结构摘要，默认 maxSheets=20,maxRows=20,maxColumns=20。附加 summary（整页已存储c节点的公式/错误等计数）及 headerCandidates（预览中候选，不自动认定标题）。自动启用结构、样式、日期解释；结构元信息仍为全页，不受预览行列限额限制。 ### fsys.openXml.xlsx.listEntries(path,pattern,options) # 识别工作簿后列真实 ZIP 条目；pattern 为可选 aardio 模式。只返回清单，不校验所有内容的 CRC。 ### fsys.openXml.xlsx.listMedia(path,options) # 列出 xl/media/ 与主部件同级 media/ 中的文件，包含子目录和未引用项。返回 partName,name,ext,size,compressedSize,contentType；不追踪所有资源关系。 ### fsys.openXml.xlsx.listSheets(path,options) # 按工作簿关系顺序返回 index,name,sheetId,rid,state,path,partName,kind 等。图表/其他非 worksheet 页也列出，但不读取其单元格。 ### fsys.openXml.xlsx.parseRange(ref) # 解析本页 A1 单格或有限矩形，支持 $/小写；返回规范 ref 与起止行列/尺寸。拒绝整行整列、多区域、工作表前缀或反向区域；失败 null,err。 ### fsys.openXml.xlsx.querySheet(path,sheet,options) # 原生结构化查询：range、header=true、columns、where、orderBy、offset=0、limit=100、aggregates。条件为 {column,op,value}，组合 all/any；不用 SQL/eval/回调。 maxScanRows=100000,maxScanCells=1000000 与结果limit分开；聚合仅已扫描匹配行。 rows项含 row,values,refs；扫描/匹配数量、scanTruncated/resultTruncated、scanComplete及范围可审计。 visibleOnly 仅反映保存的隐藏状态；DOM 解析仍扫描整个XML。 ### fsys.openXml.xlsx.read(path,options) # readWorkbook 的别名。 ### fsys.openXml.xlsx.readSheet(path,sheet,options) # 按 1 起始序号、精确名称/部件名或 listSheets 返回项读取。返回 rows,cells,summary,actualRange,selectedRange,dimension,warnings,truncated 等；原值不变。 range=A1矩形（不能同时指定起点）；maxRows/maxColumns进一步限制。 includeStructure=true 返回合并/行列/表/名称；includeStyles=true 返回保存样式；parseDates=true 附加日期/时间/时长解释。旧 startRow/row,startColumn/column,includeRows/includeCells,maxMatrixCells 及包限额仍有效；0不取。失败null,err；不是流式读取。 ### fsys.openXml.xlsx.readWorkbook(path,options) # 一次打开包读取工作簿，共享字符串只加载一次。返回 path,mainPart,date1904,sheetCount,sheets,warnings,truncated,errorCount,complete；sheets 项同 readSheet。 maxSheets=0 不取；默认任一表失败返回 null,err,partial；keepErrors=true 保留错误项。 maxMatrixCells 是本次调用所有矩形的累计格数，最高10000000；includeRows=false 不展开矩形。