fsys.openXml.xlsx 库模块帮助文档

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.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.read(path,options) #

readWorkbook 的别名。

fsys.openXml.xlsx.readSheet(path,sheet,options) #

按 1 起始序号、精确名称/部件名或 listSheets 返回项读取。
返回 path,mainPart,date1904,sheet,startRow,startColumn,rowCount,columnCount,rows,cells,warnings,truncated。
options 支持 startRow/row,startColumn/column,maxRows,maxColumns,includeRows=false,includeCells=false,maxMatrixCells=1000000 与通用包限额。
输出限额 0 不取；失败 null,err；DOM 限额不是流式读取。

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 不展开矩形。

Markdown 格式