外观 API

外观 API

Facades API 提供了简化的、面向任务的包装器，围绕核心 Aspose.PDF FOSS for .NET 对象模型。每个 facade 类针对特定的 PDF 操作——表单填写、文件合并、内容编辑或数字签名——并公开 BindPdf / Save 工作流。

使用 Form facade 填写表单

Form（在Aspose.Pdf.Facades中）绑定到现有的 PDF，并允许您在不遍历页面树的情况下读取或写入 AcroForm 字段值。

using var form = new Form("input.pdf", "output.pdf");
form.FillField("FirstName", "Alice");
form.FillField("AcceptTerms", "Yes");
form.Save();

读取字段值：

using var form = new Form("input.pdf");
string name = form.GetField("FirstName");

使用 PdfFileEditor 合并和拆分 PDF

PdfFileEditor 连接、拆分、提取并删除页面范围。

var editor = new PdfFileEditor();

// Concatenate two files
editor.Concatenate("file1.pdf", "file2.pdf", "merged.pdf");

// Extract pages 2-5
editor.Extract("source.pdf", 2, 5, "pages2to5.pdf");

// Split at page 3
editor.SplitFromFirst("source.pdf", 3, "first3.pdf");

使用 PdfContentEditor 编辑页面内容

PdfContentEditor 修改现有页面内容 — 添加文本、替换文本或将操作附加到批注。

var editor = new PdfContentEditor();
editor.BindPdf("input.pdf");
// Perform content edits
editor.Save("output.pdf");

使用 PdfFileSignature 的数字签名

PdfFileSignature 对 PDF 文档进行签名并验证现有签名。

var sig = new PdfFileSignature();
sig.BindPdf("document.pdf");
// Sign or verify
sig.Save("signed.pdf");

使用 PdfFileStamp 进行页面盖章

PdfFileStamp 将文本、图像或其他 PDF 页面叠加为印章。

var stamp = new PdfFileStamp();
stamp.BindPdf("input.pdf");
// Add stamps
stamp.Save("stamped.pdf");
stamp.Close();

使用 PdfConverter 将页面转换为图像

PdfConverter 将 PDF 页面渲染为光栅图像格式。

var converter = new PdfConverter();
converter.BindPdf("input.pdf");
converter.DoConvert();
// Iterate pages and save images

技巧与最佳实践

• 始终调用 Close() 或使用 using 来释放 facade 对象持有的资源。
• 对大文件使用带文件路径的 BindPdf，以避免一次性将所有内容加载到内存中。
• 在优雅的错误处理方面，优先使用 TryConcatenate 和 TryAppend 而不是它们的非 Try 版本。
• Facade 在内部将任务委托给核心 Document 模型——当需要细粒度控制时，请切换到核心 API。
• FormEditor facade 允许向现有 PDF 添加新表单字段，而不仅仅是填写已有字段。

常见问题

常见问题

Facades 与核心 Document API 有何区别？

Facade 提供高级、面向任务的方法（填写表单，合并文件）。 核心 API（Document、Page、Annotation）提供对 每个 PDF 对象的低层访问。Facade 在内部使用核心 API。

我可以链式调用多个 facade 操作吗？

是的。绑定相同的源，执行操作，然后一次性保存。或者保存
中间结果并在下一次操作时重新绑定。

PdfFileEditor 支持受密码保护的 PDF 吗？

是的。接受所有者/用户密码的重载可用于加密文件。

API 参考摘要

另请参见

• Aspose.PDF for .NET 企业版产品