文档化版本发布

提示

要开始使用 Documentize SDK,您可以通过多种方式将二进制文件下载到您的系统上。请根据您的具体需求选择最符合您要求的方法。

警告

通过以任何形式下载 Documentize SDK,您同意遵守 Smallize EULA

从 NuGet 获取

启动 Documentize 的最简单方法是直接从 NuGet 安装 .NET 包。以下是几种快速的方法。有关更多详细信息,请访问 NuGet 安装指南

dotnet add package Documentize
NuGet\Install-Package Documentize
<PackageReference Include="Documentize" Version="24.x.x" />

下载 MSI 安装程序

获取 Documentize 的另一种选择是下载 MSI 包,该包会安装所需的程序集(DLL)。只需单击以下下载按钮,或在 MSI 安装指南 中了解更多关于此安装方法的信息。

下载最新版本 v25.7 MSI

下载 ZIP

您也可以下载只包含 DLL 文件的 ZIP 包,您可以根据您的需求将其存储。有关更多信息,请参见 ZIP 安装指南

下载最新版本 v25.7 ZIP
2024年12月28日

文档化版本发布 的子部分

关于 Documentize

什么是 Documentize?

Documentize 是一个强大的 .NET 组件,使开发者能够程序化地创建专业和多功能的 PDF 文档,消除对 Adobe Acrobat 等外部工具的需求。

为什么使用 Documentize?

以下是 Documentize 脱颖而出的原因:

  • 轻松创建 PDF: 即时生成简单或复杂的 PDF,融入表格、图表、图像、超链接和自定义字体等元素。
  • 增强安全性: 集成强大的安全功能,以保护您的敏感 PDF 文档。
  • 灵活的开发选择: 可以选择使用用户友好的 API 或 XML 模板来创建 PDF,以简化工作流程。
  • 简化集成: Documentize 无缝集成到各种 .NET 应用程序中,包括用 C#、VB.NET 和 J# 等语言编写的 ASP.NET Web 应用程序和 Windows 应用程序。
  • 快速高效: 轻量级组件高效生成 PDF,优化您的应用程序性能。
  • 具成本效益且有支持: 享受具有竞争力的价格、卓越的性能以及全面支持,以确保顺利的开发体验。

主要特征

  • 丰富的内容支持: 向您的 PDF 添加表格、图表、图像、超链接、自定义字体等。
  • 压缩功能: 减小 PDF 文件的大小,以便于存储和分发。
  • 高级安全性: 实施安全功能,以保护 PDF 文档中的机密信息。
  • 双重创建方法: 通过程序 API 或 XML 模板创建 PDF,以提供更多灵活性。
  • 跨平台兼容性: 与各种 .NET 语言和应用程序类型无缝协作。
  • 多线程支持: 能够在不同线程上安全并发创建多个 PDF。
  • 学习资源: 访问全面的演示和 C# 工作示例,以加速您的开发过程。

适合多种行业的理想选择

Documentize 面向 PDF 生成起着关键作用的广泛行业。包括:

  • 金融和会计: 生成发票、收据、财务报告和其他重要文件。
  • 医疗: 以安全和标准化格式创建病人记录、处方和实验室报告。
  • 制造: 生成产品规格、质量控制报告和运输文件。
  • 政府和法律: 生成具有增强安全功能的许可证、执照、合同和法庭文件。
  • 教育: 创建证书、成绩单、报告和其他学术文档。

Documentize 使各行各业的开发者能够简化 PDF 创建工作流程,确保效率、安全性和灵活性。

2024年12月28日

安装

Documentize SDK 的安装

Documentize 可以通过多种方法安装,每种方法都针对不同的开发环境和偏好。以下是安装 Documentize 的推荐方式:

1. NuGet(首选方法)

NuGet 是安装 Documentize 最直接和首选的方法,确保您始终在开发环境中获得最新版本和更新。有关此安装方法的更多详细信息,请查看 如何使用 NuGet 安装 Documentize SDK

2. MSI 安装程序

如果您希望将 Documentize DLL 直接安装到系统中,MSI 安装程序是一个方便的选择。这种方法非常适合希望在多个项目中使用 Documentize 的开发人员,无需手动管理 DLL 文件。有关此安装方法的更多详细信息,请查看 如何使用 MSI 安装 Documentize SDK

3. ZIP 压缩包

对于喜欢手动操作的开发人员,ZIP 压缩包包含 Documentize DLL,您可以直接提取并添加到您的项目中。有关此安装方法的更多详细信息,请查看 如何使用 ZIP 安装 Documentize SDK

2024年12月28日

安装 的子部分

通过 NuGet 安装 Documentize


提示

NuGet 是一个免费的开源包管理器,旨在简化 .NET 中库的添加、删除和更新,如在 Visual Studio 项目中。它自动管理库文件、引用和配置更改。

如何通过 NuGet 包管理器控制台安装

  1. 打开项目:

    • 启动 Visual Studio 并打开你的 .NET 应用程序。
  2. 访问包管理器控制台:

    • 导航至 工具 > NuGet 包管理器 > 包管理器控制台
  3. 安装包:

    • 要安装最新的完整版本,输入命令 Install-Package Documentize
    • 要安装最新的版本,包括热修复,使用 Install-Package Documentize -prerelease
    • Enter 执行命令。

如何通过 NuGet 包管理器控制台更新包

如果你已经通过 NuGet 安装了 Documentize,并希望更新到最新版本:

  1. 打开项目:

    • 启动 Visual Studio 并打开你的 .NET 应用程序。
  2. 访问包管理器控制台:

    • 导航至 工具 > NuGet 包管理器 > 包管理器控制台
  3. 更新包:

    • 要更新到最新的完整版本,输入 Update-Package Documentize
    • 要更新到最新版本,包括热修复,使用 Update-Package Documentize -prerelease
    • Enter 执行命令。

如何通过 NuGet 包管理器 GUI 安装

  1. 打开项目:

    • 启动 Visual Studio 并打开你的 .NET 应用程序。
  2. 导航到管理 NuGet 包:

    • 项目 菜单中,选择 管理 NuGet 包
  3. 搜索 Documentize:

    • 进入 浏览 标签,在搜索框中输入 Documentize
  4. 安装包:

    • 点击 Documentize 最新版本旁边的 安装/更新
    • 在弹出窗口中点击 接受 确认。

使用 NuGet 的优点

  • 自动依赖管理:

    • NuGet 自动处理依赖项,确保所有所需库都包含在内并正确更新。这减少了缺失或不兼容依赖项的风险。
  • 简化更新:

    • 通过 NuGet 更新包非常简单,无论是通过包管理器控制台还是 GUI。这使得保持库更新至最新功能和错误修复变得轻而易举。
  • 与 Visual Studio 集成:

    • NuGet 与 Visual Studio 无缝集成,提供用户友好的界面,在开发环境中管理包而无需离开。
  • 版本管理:

    • NuGet 允许你指定和管理不同版本的库,使你可以轻松回退到先前版本或者测试新版本,而不破坏你的开发。

使用 NuGet 的缺点

  • 仅限于 Visual Studio:

    • NuGet 主要设计用于 Visual Studio 中使用。虽然可以在其他环境中使用,但集成在 Visual Studio 中最为强大。
  • 版本冲突的潜在可能:

    • 在有许多依赖项的大型项目中,管理版本和解决冲突可能变得复杂。NuGet 提供工具来管理此事,但需要仔细关注。
  • 网络依赖性:

    • 安装和更新包需要互联网连接。如果你在一个限制或没有互联网接入的环境中工作,你可能需要使用离线方法或预先下载包。
  • 大型项目的复杂性:

    • 对于具有大量依赖树的非常大型项目,通过 NuGet 管理包的开销可能变得烦琐。在这种情况下,可能需要额外的工具或策略来有效管理依赖项。

通过 MSI 安装 Documentize

提示

MSI 安装程序是安装 Documentize 的便捷且用户友好的选项,特别是如果您希望将 DLL 安装到系统范围内。这种方法通过自动化许多步骤简化了安装过程。

如何通过 MSI 安装程序安装

  1. 下载 MSI 安装程序:

    • 点击 v25.7 MSI 下载最新版本 Documentize 的 MSI 安装程序。
  2. 运行安装程序:

    • 双击下载的 MSI 文件以启动安装向导。
  3. 按照安装向导进行操作:

    • 按照安装程序提供的屏幕说明进行操作。您可能需要同意许可协议并选择安装选项。
  4. 完成安装:

    • 安装完成后,Documentize 的 DLL 将安装到您的系统的全局程序集缓存 (GAC) 或其他指定位置。
  5. 验证安装:

    • 通过验证指定安装目录或 GAC 中是否存在 DLL 来检查其是否正确安装。

使用 MSI 安装程序的优点

  • 易于使用:

    • MSI 安装程序提供简单且指导性的安装过程。它处理所有必要的配置,并将 DLL 放置在中心位置,使您能够在多个项目中轻松使用 Documentize。
  • 系统范围安装:

    • MSI 方法将 Documentize 安装到系统的全局程序集缓存 (GAC) 或其他中心位置。这允许系统上的任何应用程序访问 DLL,而无需在每个项目中单独引用它们。
  • 自动更新:

    • 如果 Documentize 提供了更新的安装程序,您可以通过运行新的 MSI 文件轻松更新安装,通常更新过程会顺利进行。
  • 一致性:

    • 使用 MSI 安装程序可确保所有所需文件在不同环境中正确且一致地安装,从而减少缺失或放错 DLL 的风险。

使用 MSI 安装程序的缺点

  • 灵活性有限:

    • MSI 安装程序将 Documentize 安装到系统范围位置,这可能不适合所有开发环境。它可能缺乏适应项目特定配置或版本的灵活性。
  • 潜在开销:

    • 将 DLL 安装到 GAC 可能会引入开销和复杂性,特别是在需要同时使用多个版本的 Documentize 的情况下。
  • 手动卸载:

    • 如果需要卸载 Documentize,必须使用 MSI 提供的卸载程序,如果未正确管理,可能会留下残余文件或配置。
  • 版本冲突:

    • 系统范围的安装如果不同项目需要不同版本的 Documentize,可能会导致版本冲突。管理这些冲突可能需要额外的配置或清理。

通过 ZIP 安装 Documentize

提示

ZIP 存档非常适合喜欢手动管理库的开发者。这种方法允许你直接下载并提取所需的 DLL 文件,而无需依赖包管理器或安装程序。

如何通过 ZIP 存档安装

  1. 下载 ZIP 存档

    • 点击 v25.7 ZIP 下载最新版本的 Documentize 以存档格式。
  2. 提取内容

    • 下载后,将 ZIP 文件的内容提取到你选择的目录。你可以选择将这些文件保留在共享目录或项目结构内。
  3. 将引用添加到项目中

    • 在你的 IDE 中打开项目(例如 Visual Studio)。
    • 转到 项目 > 添加引用 > 浏览,导航到你提取 DLL 的目录。
    • 选择相关的 DLL 文件并将其添加为项目的引用。
  4. 手动更新

    • 如果发布了新版本的 Documentize,你需要手动下载更新的 ZIP 存档,并用新的 DLL 文件替换项目中的旧文件。

使用 ZIP 存档的优点

  • 完全控制

    • 你可以完全控制 DLL 的存储位置和引用方式。如果你更喜欢自定义设置或需要手动管理依赖关系,这可能是有益的。
  • 不依赖包管理器

    • 与 NuGet 不同,你不依赖包管理器来处理安装。在包管理器不可用或不受欢迎的环境中,这可能是有利的。
  • 可移植性

    • ZIP 存档可以轻松分享并在不同系统之间移动,非常适合需要可移植性或分发而不依赖于外部工具的项目。

使用 ZIP 存档的缺点

  • 手动管理

    • 与 NuGet 不同,更新和依赖管理是自动化的,对于 ZIP 存档,你必须手动管理更新并确保所有所需的 DLL 都被正确引用。
  • 版本冲突的风险

    • 如果你正在管理多个项目或在团队中工作,如果不同的项目使用不同版本的 DLL,就会有版本冲突的风险。这需要仔细跟踪项目间的版本。
  • 没有自动更新

    • 当有新版本可用时,你不会收到自动更新或通知。这可能导致使用过时库的风险,除非你定期检查更新。

非Windows环境

在非Windows环境中使用.NET Core DLL

由于Documentize for .NET支持.NET Standard 2.0 (.NET Core 2.0),因此可以在Linux类操作系统中运行的Core应用程序中使用。我们一直在努力改善我们API中的.NET Core支持。然而,我们建议客户在使用Documentize for .NET的功能时执行一些操作以获得更好的效果。请安装:

  • libgdiplus包
  • 与Microsoft兼容的字体包: ttf-mscorefonts-installer(例如,sudo apt-get install ttf-mscorefonts-installer)。这些字体应该放置在/usr/share/fonts/truetype/msttcorefonts目录下,因为Documentize for .NET在Linux类操作系统中扫描此文件夹。如果操作系统有其他默认的字体文件夹/目录,则在使用Documentize执行任何操作之前,您应该使用以下代码行:
    Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<用户的ms字体路径>"));

评估

评估 Documentize for .NET

您可以轻松下载 Documentize for .NET 进行评估。评估下载与购买下载是相同的。评估版本只需添加几行代码以应用许可证即可获得授权。

Documentize 的评估版本(未指定许可证)提供完整的产品功能,但有两个限制:它插入评估水印,并且仅可以查看/编辑任何集合中的四个元素。

如果您想在没有评估版本限制的情况下测试 Documentize for .NET,您还可以申请 30 天的临时许可证。请参阅 如何获得临时许可证?

2024年12月28日

最新动态

v25.7

  • 改进了文本提取器的可用性
  • 改进了Html转换器的可用性
  • 改进了图像提取器的可用性

v25.6

  • 改进了 Tiff 转换器的可用性

v25.5

  • 新增插件: 表单导出器
  • 改进了安全性可用性

v25.4

  • 优化器可用性的改进
  • 插件拆分器可用性的改进
  • 插件合并器可用性的改进

v25.3

  • 添加新插件:表单扁平化工具

v25.2

  • 新增插件:目录生成器

v25.1

  • 改进的插件:ImageExtractor

v24.12

  • 新增插件:PDF 转 PNG 转换器
  • 新增插件:PDF 转 TIFF 转换器
  • 新增插件:PDF 表格生成器
  • 将类 PdfDoc 重命名为 DocConverter

v24.11

  • 添加新插件:PDF到JPEG转换器
  • 添加类 DirectoryDataSource
  • 添加类 PdfToJpegOptions

v24.10

  • 新增插件:PDF/A 转换器

v24.9

  • 发布
2024年12月28日

最新动态 的子部分

v25.7

改进了文本提取器的可用性

  • Class TextExtractor: 是静态的,不需要使用构造函数。
  • Class TextExtractor: 在评估模式下运行时改善了行为。处理4页以上的文档时没有异常。
  • Class TextExtractor: 修复了方法 Process 中的问题。
  • Class PdfExtractorOptions: 已移除。
  • Class TextExtractorOptions: 已重构。
  • Enum TextFormattingMode: 已重命名并改进。

使用示例:

// 该示例演示如何提取PDF文档的文本内容。
// 创建 TextExtractorOptions 对象以设置指令
var options = new TextExtractorOptions(TextFormattingMode.Pure);
// 添加输入文件路径
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// 执行处理
var results = TextExtractor.Process(options);
// 从 ResultContainer 对象中获取提取的文本
var textExtracted = results.ResultCollection[0].ToString();

改进了Html转换器的可用性

  • Class HtmlConverter: 是静态的,不需要使用构造函数。
  • Class HtmlConverter: 修复了方法 Process 中的问题。
  • Class HtmlConverter: 移除了IDisposable逻辑。
  • Class PdfConverterOptions: 已移除。

使用示例:

// 该示例演示如何将PDF转换为HTML文档。
// 创建 PdfToHtmlOptions 对象以设置输出数据类型为带嵌入资源的文件
var options = new PdfToHtmlOptions(PdfToHtmlOptions.SaveDataType.FileWithEmbeddedResources);
// 添加输入文件路径
options.AddInput(new FileDataSource("path_to_input.pdf"));
// 设置输出文件路径
options.AddOutput(new FileDataSource("path_to_output.html"));
// 执行处理
HtmlConverter.Process(options);

// 该示例演示如何将HTML转换为PDF文档。
// 创建 HtmlToPdfOptions
var options = new HtmlToPdfOptions();
// 添加输入文件路径
options.AddInput(new FileDataSource("path_to_input.html"));
// 设置输出文件路径
options.AddOutput(new FileDataSource("path_to_output.pdf"));
// 执行处理
HtmlConverter.Process(options);

改进了图像提取器的可用性

  • Class ImageExtractor: 是静态的,不需要使用构造函数。

使用示例:

// 该示例演示如何从PDF文档中提取图像。
// 创建 ImageExtractorOptions 以设置指令
var options = new ImageExtractorOptions();
// 添加输入文件路径
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// 设置输出目录路径
options.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// 执行处理
var results = ImageExtractor.Process(options);
// 获取图像结果的路径
var imageExtracted = results.ResultCollection[0].ToFile();

小修复

  • 内部修复。
  • 修复了Tiff转换器的示例和提示。
  • 减少了页面优化的持续时间。
  • 修复了:PDF到PNG转换中,输出图像不正确。
  • 修复了:PDF到PNG转换中,中文字符显示不正确。
  • 改进了:PDF到HTML转换期间的性能。
2025年7月10日

v25.6

改进了 Tiff 转换器的可用性

  • Class PdfToTiffOptions: 添加了额外的转换参数 - 压缩。
  • Class PdfToTiffOptions: 添加了额外的转换参数 - 色深。
  • Class TiffConverter 是静态的,不需要使用构造函数。
  • 改进了主要示例。

示例用法:

// 该示例演示如何将 PDF 文档转换为 TIFF 格式。
// 创建 PdfToTiffOptions 对象以设置指令
var options = new PdfToTiffOptions();
// 添加输入文件路径
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// 设置输出目录路径
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// 执行该过程
TiffConverter.Process(options);

// 该示例演示如何将 PDF 文档转换为 TIFF 格式并使用附加参数。
// 创建 PdfToTiffOptions 对象以设置指令
var options = new PdfToTiffOptions();
// 添加输入文件路径
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// 设置输出目录路径
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// 可选参数
options.PageList = new List<int> { 1, 3 };
options.MultiPage = true;
options.OutputResolution = 400;
options.Compression = TiffCompression.RLE;
options.ColorDepth = TiffColorDepth.Format24bpp;
// 执行该过程
TiffConverter.Process(options);

小修复

  • 内部修复。
2025年7月10日

v25.5

新增插件: 表单导出器

  • Class FormExporter: 代表 Documentize.FormExporter 插件,用于将 PDF 文档的表单值导出到 DSV 或 CSV 文件中
  • Class FormExportToDsvOptions: 代表使用 Documentize.FormExporter 插件将 PDF 文档的值导出到 DSV 或 CSV 文件的选项。

示例用法:

// 该示例演示如何将表单值导出到 CSV 文件。
// 创建 FormExportToDsvOptions 对象以设置指令
var options = new FormExportToDsvOptions(',', true);
// 添加输入文件路径
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// 设置输出文件路径
options.AddOutput(new FileDataSource("path_to_result_csv_file.csv"));
// 执行处理
FormExporter.Process(options);

改进了安全性可用性

  • 该类是静态的,不需要使用构造函数。
  • 改进了主要示例。

示例用法:

// 该示例演示如何加密 PDF 文档。
// 创建 EncryptionOptions 对象以设置指令
var options = new EncryptionOptions("123456", "qwerty");
// 添加输入文件路径
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// 设置输出文件路径
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// 执行处理
Security.Process(options);

// 该示例演示如何解密 PDF 文档。
// 创建 DecryptionOptions 对象以设置指令
var options = new DecryptionOptions("123456");
// 添加输入文件路径
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// 设置输出文件路径
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// 执行处理
Security.Process(options);

小修复

  • 改进了类提示和许可证。
2025年7月10日

v25.4

优化器可用性的改进

  • 该类是静态的,不需要使用构造函数。
  • 改进了主要示例。
  • 添加了额外的示例。

示例用法:

// 该示例演示如何优化PDF文档。
// 创建OptimizeOptions对象来设置指令
var options = new OptimizeOptions();
// 添加输入文件路径
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// 设置输出文件路径
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// 执行处理
Optimizer.Process(options);

// 该示例演示如何旋转PDF文档。
// 创建RotateOptions对象来设置指令
var options = new RotateOptions();
// 设置新的旋转
options.Rotation = Rotation.On90;
// 添加输入文件路径
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// 设置输出文件路径
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// 执行处理
Optimizer.Process(options);

// 该示例演示如何调整PDF文档的大小。
// 创建ResizeOptions对象来设置指令
var options = new ResizeOptions();
// 设置新的页面大小
options.PageSize = PageSize.A3;
// 添加输入文件路径
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// 设置输出文件路径
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// 执行处理
Optimizer.Process(options);

// 该示例演示如何压缩PDF文档。
// 创建CompressOptions对象来设置指令
var options = new CompressOptions();
// 添加输入文件路径
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// 设置输出文件路径
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// 执行处理
Optimizer.Process(options);

插件拆分器可用性的改进

  • 该类是静态的,不需要使用构造函数。
  • 改进了主要示例。

示例用法:

// 该示例演示如何拆分PDF文档。
// 创建SplitOptions对象来设置指令
var options = new SplitOptions();
// 添加输入文件路径
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// 设置输出文件路径
options.AddOutput(new FileDataSource("path_to_result_pdf_file_1.pdf"));
options.AddOutput(new FileDataSource("path_to_result_pdf_file_2.pdf"));
// 执行处理
Splitter.Process(options);

插件合并器可用性的改进

  • 该类是静态的,不需要使用构造函数。
  • 改进了主要示例。

示例用法:

// 该示例演示如何合并两个PDF文档。
// 创建MergeOptions对象来设置指令
var options = new MergeOptions();
// 添加输入文件路径
options.AddInput(new FileDataSource("path_to_your_pdf_file_1.pdf"));
options.AddInput(new FileDataSource("path_to_your_pdf_file_2.pdf"));
// 设置输出文件路径
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// 执行处理
Merger.Process(options);

小修复

  • 改进了类提示。
2025年7月10日

v25.3

添加新插件:表单扁平化工具

  • Class FormFlattener:表示 Documentize.FormFlattener 插件,用于扁平化 PDF 文档中的字段。
  • Class FormFlattenerOptions:表示通过 Documentize.FormFlattener 插件在文档中扁平化字段的选项。

示例用法:

//该示例演示如何扁平化 PDF 文件中的字段。
// 创建 FormFlattenerOptions 对象以设置指令
var options = new FormFlattenerOptions();
// 添加输入文件路径
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// 设置输出文件路径
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
//可选参数,跳过名称为“Surname”的字段。
options.SkipFields.Add("Surname");
// 执行该过程
FormFlattener.Process(options);

//该示例演示如何从 PDF 文件中获取字段名称。
var fieldNames = FormFlattener.GetFieldNames("path_to_your_pdf_file.pdf");

小修复

  • 改进了类提示和示例。
2025年7月10日

v25.2

新增插件:目录生成器

  • Class TocGenerator: 表示 Documentize.TocGenerator 插件。用于向 PDF 文档添加目录。
  • Class TocOptions: 表示通过 Documentize.TocGenerator 插件向文档添加目录的选项。
  • Class TocHeading: 表示通过 Documentize.TocGenerator 插件向文档添加目录的标题或章节选项。

示例用法:

// 该示例演示如何向 PDF 文件添加目录。
var options = new TocOptions();
// 设置标题
options.Title = "我的目录";
// 在书签中生成链接
options.GenerateBookmarks = true;
// 设计标题
options.Headings.Add(new TocHeading("引言", 2, false, 1));
options.Headings.Add(new TocHeading("第一章", 3, true, 1));
options.Headings.Add(new TocHeading("第二章", 4, true, 1));
options.Headings.Add(new TocHeading("示例 A", 4, true, 2));
options.Headings.Add(new TocHeading("示例 B", 4, true, 2));
options.Headings.Add(new TocHeading("示例 C", 4, true, 2));
options.Headings.Add(new TocHeading("示例 D", 4, true, 2));
options.Headings.Add(new TocHeading("第三章", 5, true, 1));
// 添加输入文件路径
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// 设置输出文件路径
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// 执行处理
TocGenerator.Process(options);

小修复

  • 改进了类提示和示例。
  • 更新了水印。
  • 改进了 PDF 转换为 XSLX。
  • 改进了 PDF 转换为 PDF/A-1a。
2025年7月10日

v25.1

改进的插件:ImageExtractor

  • 添加了输出集合到 ImageExtractorOptions。
  • 添加了对 ImageExtractorOptions 的多个输入的支持。
  • 修复了关闭的输出流。

示例用法:

// 创建 ImageExtractor 对象以提取图像
var plugin = new ImageExtractor();
// 创建 ImageExtractorOptions
var opt = new ImageExtractorOptions();
// 添加输入文件路径
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// 设置输出目录
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// 执行提取过程
var resultContainer = plugin.Process(opt);
// 从 ResultContainer 对象中获取图像
var imageExtracted = resultContainer.ResultCollection[0].ToFile();

小修复

  • 改进类提示和示例。
  • PDF 签名验证。
  • 改进了对中文字符的支持。
2025年7月10日

v24.12

新增插件:PDF 转 PNG 转换器

  • 类 PngConverter:表示 Documentize.PngConverter 插件。用于将 PDF 文档转换为 PNG 格式。
  • 类 PdfToPngOptions:表示 Documentize.PngConverter 插件的 PDF 到 PNG 转换选项。

示例用法:

// 创建 PngConverter
var plugin = new PngConverter();
// 创建 PdfToPngOptions 对象以设置指令
var opt = new PdfToPngOptions();
// 添加输入文件路径
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// 设置输出文件路径
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// 执行处理
plugin.Process(opt);

新增插件:PDF 转 TIFF 转换器

  • 类 TiffConverter:表示 Documentize.TiffConverter 插件。用于将 PDF 文档转换为 TIFF 格式。
  • 类 PdfToTiffOptions:表示 Documentize.TiffConverter 插件的 PDF 到 TIFF 转换选项。

示例用法:

// 创建 TiffConverter
var plugin = new TiffConverter();
// 创建 PdfToTiffOptions 对象以设置指令
var opt = new PdfToTiffOptions();
// 添加输入文件路径
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// 设置输出文件路径
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// 执行处理
plugin.Process(opt);

新增插件:PDF 表格生成器

  • 类 TableGenerator:表示 Documentize.TableGenerator 插件。用于向 PDF 文档添加表格。
  • 类 TableBuilder:表示 PDF 页面中表格的构建器的类。
  • 类 TableRowBuilder:表示表格行的构建器的类。
  • 类 TableCellBuilder:表示表格单元格的构建器的类。

示例用法:

// 创建 TableGenerator
var plugin = new TableGenerator();
// 创建 TableOptions 对象以设置指令
TableOptions opt = new TableOptions().InsertPageBefore(1)
   .AddTable()
        .AddRow()
            .AddCell().AddParagraph("名称")
            .AddCell().AddParagraph("年龄")
        .AddRow()
            .AddCell().AddParagraph("Bob")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Sam")
            .AddCell().AddParagraph("20")
        .AddRow()
            .AddCell().AddParagraph("Sandy")
            .AddCell().AddParagraph("26")
        .AddRow()
            .AddCell().AddParagraph("Tom")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Jim")
            .AddCell().AddParagraph("27");
// 添加输入文件路径
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// 设置输出文件路径
opt.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));
// 执行处理
plugin.Process(opt);

将类 PdfDoc 重命名为 DocConverter

  • 类 DocConverter:表示 Documentize.DocConverter 插件。用于将 PDF 文档转换为 DOC/DOCX 格式。

示例用法:

// 创建 DocConverter
var plugin = new DocConverter();
// 创建 PdfToDocOptions 对象以设置指令
var opt = new PdfToDocOptions();
// 添加输入文件路径
opt.AddInput(new FileDataSource(inputPath));
// 设置输出文件路径
opt.AddOutput(new FileDataSource(outputPath));
// 执行处理
plugin.Process(opt);
2025年7月10日

v24.11

添加新插件:PDF到JPEG转换器

  • 目的JpegConverter 类旨在将 PDF 文档转换为 JPEG 格式,使用户更容易处理和共享来自 PDF 的图像。
  • 构造函数
    • JpegConverter():初始化 JPEG 转换器的新实例。

示例用法:

var plugin = new JpegConverter();
var opt = new PdfToJpegOptions();
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
plugin.Process(opt);
  • 方法
    • Process(PdfToJpegOptions options):使用指定的选项启动 JPEG 转换过程。

添加类 DirectoryDataSource

  • 目的DirectoryDataSource 类允许用户管理用于插件中加载和保存操作的目录数据。
  • 构造函数
    • DirectoryDataSource(string path):使用指定路径初始化新的目录数据对象。

示例用法:

var directorySource = new DirectoryDataSource("path_to_your_directory");
  • 属性
    • DataType:检索数据源的类型。
    • Path:获取当前数据目录的路径。

添加类 PdfToJpegOptions

  • 目的:此类包含用于配置 JPEG 转换过程的选项,允许用户指定分辨率、页面列表和图像质量。
  • 构造函数
    • PdfToJpegOptions():为 JPEG 转换器初始化新的选项实例。

属性:

  • OutputResolution:指定生成的 JPEG 图像的分辨率。
  • PageList:要从 PDF 转换的页面列表。
  • Quality:设置 JPEG 输出的质量。
2025年7月10日

v24.10

新增插件:PDF/A 转换器

  • 引入了一项新的 PDF/A 转换功能,允许用户轻松将标准 PDF 文件转换为符合 PDF/A 的文档。

使用示例:

var options = new PdfAConvertOptions
{
    PdfAVersion = PdfAStandardVersion.PDF_A_3B
};

options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
options.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));

var plugin = new PdfAConverter();
plugin.Process(options);

修复的漏洞

  • 修复了与 FileResult 类相关的问题,导致输出路径不正确。
  • 解决了在处理大文件时影响 HtmlConverter 的小错误。

改进

  • 增强了 PdfExtractorImageExtractor 的性能,以实现更快的处理时间。
  • 更新了 RotateOptions 类以支持额外的旋转角度。
2025年7月10日

v24.9

发布

 中文