常见问题

许可与开源

什么是 Aspose.Words FOSS for .NET 的许可模式?

Aspose.Words FOSS for .NET 在 MIT 许可证下发布。您可以在个人、商业和闭源项目中免费使用它,无需版税,也无需运行时许可证密钥或激活步骤——您只需在分发的任何软件副本中保留版权声明和许可证文本。

此 FOSS 版与商业版 Aspose.Words for .NET 有何区别?

Aspose.Words FOSS for .NET 并不是一次重写或包装——它是实际的 Aspose.Words 用于 .NET 源代码的版本,已简化为自由、开源的核心。它公开了与商业产品相同的 Document Object Model(Document, DocumentBuilder, Section, Paragraph, Run, Table,以及相关类),但省略了页面布局和渲染子系统、若干遗留和开放文档格式、邮件合并执行、LINQ 报告、文档比较以及嵌入式字体子集化。可以验证数字签名,但不能创建。请参阅下面的格式和限制问题以获取具体信息。需要完整功能集的开发者可以使用 Aspose.Words for .NET 与这些开源资源一起使用。

安装与要求

如何安装 Aspose.Words FOSS for .NET?

该库可通过 NuGet 获取,或通过源码构建。克隆仓库并在 Release 配置下构建解决方案,然后在自己的应用程序中添加对 Aspose.Words.csproj 的项目引用:

git clone https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git
cd Aspose.Words-FOSS-for-.NET
dotnet build Aspose.Words.sln -c Release

支持哪些 .NET 版本和操作系统?

该库面向 .NET Standard 2.0,因此可运行在 .NET Framework 4.6.2+ 和 .NET 6/8/10 上,支持 Windows、Linux 和 macOS。它是纯托管的 C#,没有本机依赖,因此无需安装额外的系统软件包。

格式支持

哪些文件格式可以由 Aspose.Words 为 .NET 的 FOSS 读取和写入?

格式LoadSave
DOCX是是
DOCM是是
DOTX是是
DOTM是是
Flat OPC (加上启用宏的和模板变体)是是
Markdown是是
纯文本是是

DOCX、DOCM、DOTX、DOTM 和 Flat OPC 均使用相同的 OOXML 读取/写入器。

我可以加载或保存 DOC、RTF、ODT、HTML 或 EPUB 文件吗?

不。此版本的格式列表仅包含 DOCX、DOCM、DOTX、DOTM、Flat OPC、Markdown 和纯文本——.doc、.rtf、.odt、.html 和 .epub 不在此列表中,打开任何此类文件都会抛出异常。

Aspose.Words FOSS for .NET 能将文档导出为 PDF、XPS 或图像格式吗?

不。此版本不包含页面布局和渲染子系统,因此 Document.Save() 无法导出为 PDF、XPS 或图像格式。

请改为保存为 DOCX、DOCM、DOTX、DOTM、Flat OPC、Markdown 或纯文本。针对 .NET 的商业版 Aspose.Words 增加了 PDF、XPS 和图像格式。

API Usage

我该如何创建新文档?

构造一个 Document,将其包装在 DocumentBuilder 中,并使用构建器的高级方法在保存前插入内容:

using Aspose.Words;

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Writeln("Hello, Aspose.Words FOSS!");

doc.Save("output.docx");

我该如何加载现有的 DOCX 文档?

将文件路径传递给 Document 构造函数:new Document("input.docx")。同一构造函数也接受 Stream,两者都有接受 LoadOptions 对象的重载,以便更细致地控制文件的解析方式。

像 DATE 或 DOCPROPERTY 这样的字段是如何更新的?

Aspose.Words FOSS for .NET 包含完整的字段评估引擎,因此内容字段如 DATE、DOCPROPERTY、REF、SEQ 和邮件合并字段会以编程方式更新。依赖页面布局的字段——例如目录中的页码——会评估为占位符 0,而不是计算值,因为此版本不包含通常用于分页文档的布局引擎。

已知限制

此版本是否支持执行邮件合并、LINQ 报告或文档比较?

不。邮件合并执行、LINQ 报告、文档比较以及嵌入式字体子集化都不包含在此 FOSS 版本中。用于建模邮件合并设置和字段的类(例如 MailMergeSettings)在对象模型中存在,但实际执行合并并不属于此版本的功能。

Aspose.Words FOSS for .NET 能在文档上创建数字签名吗?

不。此版本可以检查并验证已附加到 .docx 文件的数字签名——通过 Document.DigitalSignatures、DigitalSignatureUtil.LoadSignatures() 以及 DigitalSignature/DigitalSignatureCollection 类——但无法创建新的签名。签名工作流需要商业版 Aspose.Words for .NET。

是否支持嵌入式字体子集化?

不。当 EmbedTrueTypeFonts 启用时,字体会作为完整文件嵌入,而不是仅子集化为文档中实际使用的字形。

另请参阅

 中文