# DocumentFormat.OpenXml 库模块帮助文档

<details>  <summary>使用约定</summary>  <p>

本库面向 AI，只提示少量常用入口；其余 API 直接使用原生 SDK，按需查微软文档。
字符串路径自动经 `io.fullpath` 转换，流对象透传；`Open` 默认只读。
SDK 调用失败可能抛出异常；使用完文档须调用 `Dispose()`，调用方创建的流由调用方释放。
结构验证不等于排版、渲染或公式计算正确。

</p></details>

[使用指南](https://www.aardio.com/zh-cn/docs/library/DocumentFormat/OpenXml/) [结构验证](https://www.aardio.com/zh-cn/docs/library/DocumentFormat/OpenXml/validation.html) [调用示例](https://www.aardio.com/zh-cn/docs/library/DocumentFormat/OpenXml/examples.html)

## DocumentFormat.OpenXml 成员列表 <a id="DocumentFormat.OpenXml" href="#DocumentFormat.OpenXml">&#x23;</a>

Microsoft Open XML SDK 3.5.1（net35），直接操作 DOCX / XLSX / PPTX；不依赖 Office。  
通过 dotNet 加载 .NET Framework 程序集，其他 API 按需查上游文档。

### DocumentFormat.OpenXml.* <a id="DocumentFormat.OpenXml.any" href="#DocumentFormat.OpenXml.any">&#x23;</a>
原生 .NET SDK 成员。  

[返回对象:dotNetNameSpaceObject](https://www.aardio.com/zh-cn/docs/library-reference/dotNet/appDomain.html#dotNetNameSpaceObject)

## DocumentFormat.OpenXml.Packaging 成员列表 <a id="DocumentFormat.OpenXml.Packaging" href="#DocumentFormat.OpenXml.Packaging">&#x23;</a>

文档包入口。

### DocumentFormat.OpenXml.Packaging.OpenSettings() <a id="DocumentFormat.OpenXml.Packaging.OpenSettings" href="#DocumentFormat.OpenXml.Packaging.OpenSettings">&#x23;</a>
创建原生打开设置，可作为 Open 的第 3 个参数。

## DocumentFormat.OpenXml.Packaging.PresentationDocument 成员列表 <a id="DocumentFormat.OpenXml.Packaging.PresentationDocument" href="#DocumentFormat.OpenXml.Packaging.PresentationDocument">&#x23;</a>

PowerPoint 文档包。

### DocumentFormat.OpenXml.Packaging.PresentationDocument.Create(pathOrStream,documentType,autoSave) <a id="DocumentFormat.OpenXml.Packaging.PresentationDocument.Create" href="#DocumentFormat.OpenXml.Packaging.PresentationDocument.Create">&#x23;</a>
新建文档包；路径经 io.fullpath 转换，也可传 Stream。  
documentType 默认 0（Presentation），autoSave 默认 true；已有文件会被覆盖。  

[返回对象:OpenXmlPresentationDocumentObject](#OpenXmlPresentationDocumentObject)

### DocumentFormat.OpenXml.Packaging.PresentationDocument.Open(pathOrStream,editable,openSettings) <a id="DocumentFormat.OpenXml.Packaging.PresentationDocument.Open" href="#DocumentFormat.OpenXml.Packaging.PresentationDocument.Open">&#x23;</a>
打开路径或 Stream；editable 默认 false，openSettings 可省略。  

[返回对象:OpenXmlPresentationDocumentObject](#OpenXmlPresentationDocumentObject)

## DocumentFormat.OpenXml.Packaging.SpreadsheetDocument 成员列表 <a id="DocumentFormat.OpenXml.Packaging.SpreadsheetDocument" href="#DocumentFormat.OpenXml.Packaging.SpreadsheetDocument">&#x23;</a>

Excel 文档包。

### DocumentFormat.OpenXml.Packaging.SpreadsheetDocument.Create(pathOrStream,documentType,autoSave) <a id="DocumentFormat.OpenXml.Packaging.SpreadsheetDocument.Create" href="#DocumentFormat.OpenXml.Packaging.SpreadsheetDocument.Create">&#x23;</a>
新建文档包；路径经 io.fullpath 转换，也可传 Stream。  
documentType 默认 0（Workbook），autoSave 默认 true；已有文件会被覆盖。  

[返回对象:OpenXmlSpreadsheetDocumentObject](#OpenXmlSpreadsheetDocumentObject)

### DocumentFormat.OpenXml.Packaging.SpreadsheetDocument.Open(pathOrStream,editable,openSettings) <a id="DocumentFormat.OpenXml.Packaging.SpreadsheetDocument.Open" href="#DocumentFormat.OpenXml.Packaging.SpreadsheetDocument.Open">&#x23;</a>
打开路径或 Stream；editable 默认 false，openSettings 可省略。  

[返回对象:OpenXmlSpreadsheetDocumentObject](#OpenXmlSpreadsheetDocumentObject)

## DocumentFormat.OpenXml.Packaging.WordprocessingDocument 成员列表 <a id="DocumentFormat.OpenXml.Packaging.WordprocessingDocument" href="#DocumentFormat.OpenXml.Packaging.WordprocessingDocument">&#x23;</a>

Word 文档包。

### DocumentFormat.OpenXml.Packaging.WordprocessingDocument.Create(pathOrStream,documentType,autoSave) <a id="DocumentFormat.OpenXml.Packaging.WordprocessingDocument.Create" href="#DocumentFormat.OpenXml.Packaging.WordprocessingDocument.Create">&#x23;</a>
新建文档包；路径经 io.fullpath 转换，也可传 Stream。  
documentType 默认 0（Document），autoSave 默认 true；已有文件会被覆盖。  

[返回对象:OpenXmlWordDocumentObject](#OpenXmlWordDocumentObject)

### DocumentFormat.OpenXml.Packaging.WordprocessingDocument.Open(pathOrStream,editable,openSettings) <a id="DocumentFormat.OpenXml.Packaging.WordprocessingDocument.Open" href="#DocumentFormat.OpenXml.Packaging.WordprocessingDocument.Open">&#x23;</a>
打开路径或 Stream；editable 默认 false，openSettings 可省略。  

[返回对象:OpenXmlWordDocumentObject](#OpenXmlWordDocumentObject)

## DocumentFormat.OpenXml.Validation 成员列表 <a id="DocumentFormat.OpenXml.Validation" href="#DocumentFormat.OpenXml.Validation">&#x23;</a>

结构验证入口。

### DocumentFormat.OpenXml.Validation.OpenXmlValidator(fileFormat) <a id="DocumentFormat.OpenXml.Validation.OpenXmlValidator" href="#DocumentFormat.OpenXml.Validation.OpenXmlValidator">&#x23;</a>
创建结构验证器；fileFormat 为 FileFormatVersions 的单个版本，默认 Office2007。  

[返回对象:OpenXmlValidatorObject](#OpenXmlValidatorObject)

## OpenXmlPresentationDocumentObject 成员列表 <a id="OpenXmlPresentationDocumentObject" href="#OpenXmlPresentationDocumentObject">&#x23;</a>

### OpenXmlPresentationDocumentObject.Dispose() <a id="OpenXmlPresentationDocumentObject.Dispose" href="#OpenXmlPresentationDocumentObject.Dispose">&#x23;</a>
关闭文档包并释放占用；可编辑且 AutoSave 为 true 时自动保存。

### OpenXmlPresentationDocumentObject.PresentationPart <a id="OpenXmlPresentationDocumentObject.PresentationPart" href="#OpenXmlPresentationDocumentObject.PresentationPart">&#x23;</a>
PowerPoint 演示文稿部件。

## OpenXmlSpreadsheetDocumentObject 成员列表 <a id="OpenXmlSpreadsheetDocumentObject" href="#OpenXmlSpreadsheetDocumentObject">&#x23;</a>

### OpenXmlSpreadsheetDocumentObject.Dispose() <a id="OpenXmlSpreadsheetDocumentObject.Dispose" href="#OpenXmlSpreadsheetDocumentObject.Dispose">&#x23;</a>
关闭文档包并释放占用；可编辑且 AutoSave 为 true 时自动保存。

### OpenXmlSpreadsheetDocumentObject.WorkbookPart <a id="OpenXmlSpreadsheetDocumentObject.WorkbookPart" href="#OpenXmlSpreadsheetDocumentObject.WorkbookPart">&#x23;</a>
Excel 工作簿部件。

## OpenXmlValidatorObject 成员列表 <a id="OpenXmlValidatorObject" href="#OpenXmlValidatorObject">&#x23;</a>

### OpenXmlValidatorObject.MaxNumberOfErrors <a id="OpenXmlValidatorObject.MaxNumberOfErrors" href="#OpenXmlValidatorObject.MaxNumberOfErrors">&#x23;</a>
最大错误数，默认 1000；0 表示不设上限。

### OpenXmlValidatorObject.Validate(target) <a id="OpenXmlValidatorObject.Validate" href="#OpenXmlValidatorObject.Validate">&#x23;</a>
校验文档包、部件或元素，返回错误集合；用 dotNet.each 遍历。  
须在释放文档前完成枚举，验证失败可能抛出异常。

## OpenXmlWordDocumentObject 成员列表 <a id="OpenXmlWordDocumentObject" href="#OpenXmlWordDocumentObject">&#x23;</a>

### OpenXmlWordDocumentObject.Dispose() <a id="OpenXmlWordDocumentObject.Dispose" href="#OpenXmlWordDocumentObject.Dispose">&#x23;</a>
关闭文档包并释放占用；可编辑且 AutoSave 为 true 时自动保存。

### OpenXmlWordDocumentObject.MainDocumentPart <a id="OpenXmlWordDocumentObject.MainDocumentPart" href="#OpenXmlWordDocumentObject.MainDocumentPart">&#x23;</a>
Word 主部件；正文为 MainDocumentPart.Document.Body。
