Aspose.PDF

Aspose.PDF FOSS for .NET 是一个免费、MIT 许可证的 .NET 库，用于读取、创建和操作 PDF 文档。该库在宽松的开源许可证下发布，消除了企业级 PDF 功能的传统障碍——库中的每个功能都无需购买商业许可证即可使用。 Aspose.PDF FOSS for .NET 是什么？ 该库面向 .NET 8 及更高版本。它已发布到 NuGet，包 ID 为 Aspose.Pdf.Foss，可以通过一条命令将其添加到任何 .NET 8+ 项目中： dotnet add package Aspose.Pdf.Foss --version 0.1.0-alpha 主要命名空间是 Aspose.Pdf，相关命名空间包括 Aspose.Pdf.Text、Aspose.Pdf.Forms 和 Aspose.Pdf.Facades。该库公开了 805 个公共 API 类，支持 7,488 条已记录的声明以及直接从测试套件中提取的 100 段代码片段。 核心功能 API 覆盖 PDF 文档的完整生命周期： 文档创建和加载 — Document.Create() 生成一个空白文档；Document.Open(data) 从字节数组或流加载现有 PDF。 页面和内容访问 — Pages 集合提供基于 1 的索引访问单个页面，每个页面都公开注释、操作符和内容流。 文本提取 — TextFragmentAbsorber 访问页面并收集每个文本片段，支持可选的搜索短语过滤和正则表达式。 交互操作 — PdfAction.CreateUri、PdfAction.CreateGoTo、PdfAction.CreateJavaScript 和 PdfAction.CreateLaunch 覆盖标准 PDF 操作类型。 注释 — AnnotationCollection.AddLinkAnnotation 将带有关联操作的链接注释附加到页面上的任意矩形区域。 表单 — Aspose.Pdf.Forms 命名空间和 Aspose.Pdf.Facades 提供对 AcroForm 字段、外观格式以及字段级 JavaScript 扩展的访问。 打开文档并添加链接 以下示例演示了往返模式：创建一个新的 PDF 文档，在首页添加 URI 动作链接注释，将其保存到流中，然后重新加载以验证注释是否仍然存在。 ...

核心 PDF 文档管理涵盖几乎所有 PDF 工作流中出现的操作：打开或创建文档、访问页面及其内容、读取和写入批注、提取文本以及处理交互式操作。Aspose.PDF FOSS for .NET 提供了一个 .NET 8+ API，通过以 Document 和 Page 类型为中心的一致对象模型来处理所有这些任务。 文档生命周期：创建，打开，保存 每个工作流都从创建新文档或加载现有文档开始。Document.Create() 返回一个新的空 Document 实例。Document.Open(data) 接受 byte[] 或 Stream 并解析 PDF 结构： using var doc = Document.Create(); doc.Pages.Add(); var page = doc.Pages[1]; var action = PdfAction.CreateUri("https://aspose.com"); page.Annotations.AddLinkAnnotation(new Rectangle(50, 700, 200, 720), action); using var ms = new MemoryStream(); doc.Save(ms); ms.Position = 0; using var doc2 = Document.Open(ms.ToArray()); var annot = (LinkAnnotation)doc2.Pages[1].Annotations[1]; Console.WriteLine(annot.Uri); // https://aspose.com 此代码段打开一个最小的 PDF，在第 1 页添加链接注释，保存到 MemoryStream，并验证重新加载后注释仍然保留。Document.Save(Stream) 重载写入完整的更新结构；Document.ToArray() 直接返回字节。 ...

Document 类是 Aspose.PDF FOSS for .NET 的核心。它代表一个完整的 PDF，并提供对内部每个结构的访问——页面、注释、表单字段、元数据和嵌入文件。 打开文档 从文件、字节数组或流加载 PDF： using var doc = Document.Open(File.ReadAllBytes("input.pdf")); Console.WriteLine($"Pages: {doc.Pages.Count}"); 页面使用基于 1 的索引：doc.Pages[1] 是第一页。 从头开始创建 using var doc = new Document(); var page = doc.Pages.Add(); page.Paragraphs.Add(new TextFragment("Hello, PDF!")); doc.Save("hello.pdf"); 表格、浮动框、页眉/页脚以及图表都是布局引擎自动放置的段落类型。 页面操作 设置页面几何形状、旋转和边界框： var page = doc.Pages[1]; page.SetMediaBox(new Rectangle(0, 0, 612, 792)); page.SetCropBox(new Rectangle(36, 36, 576, 756)); page.SetRotation(90); 转换 该库包含针对多种输出格式的专用转换器： 转换器 输出 PdfToHtmlConverter HTML PdfToMarkdownConverter Markdown PdfToSvgConverter SVG PdfToTextConverter 纯文本 渲染为光栅图像使用设备类（PngDevice, JpegDevice, TiffDevice, BmpDevice），每个接受以 DPI 为单位的 Resolution。 PDF/A 合规性 验证并将文档转换为 PDF/A-1B、PDF/A-2B 或 PDF/A-3B： ...

Aspose.PDF FOSS for .NET 随附一套丰富的注释和表单字段 API，允许您在完全托管的代码中对 PDF 文档进行标注、链接和交互——无需许可证密钥。 注释概览 库的 AnnotationCollection 类为每个标准 PDF 注释提供了类型化的帮助方法。添加便签只需一次调用： page.Annotations.AddTextAnnotation( new Rectangle(72, 720, 200, 740), contents: "Review needed", title: "Editor", open: true); 链接注释将可点击的矩形与 PdfAction 结合在一起： var action = PdfAction.CreateUri("https://aspose.com"); page.Annotations.AddLinkAnnotation( new Rectangle(50, 700, 200, 720), action); 相同的模式适用于高亮、下划线、方框、圆形、线条和墨迹（手绘）批注 — 每种都有专用的 Add* 方法。 交互式表单字段 AcroForm 字段通过 Document.Form 访问。遍历 Form.Fields 读取字段值，或使用 Form 门面进行高级填充操作： using var form = new Form("input.pdf", "output.pdf"); form.FillField("Name", "Alice"); form.Save(); 字段子类包括 TextBoxField、CheckboxField、RadioButtonField, ComboBoxField、ListBoxField和 SignatureField。 扁平化与访问者模式 调用 Annotation.Flatten() 将注释的视觉外观烧录到页面内容中。使用 AnnotationSelector 通过访问者模式按类型过滤注释——无需手动强制转换。 入门 入门指南 开发者指南 知识库文章 API 参考 使用以下方式安装： ...