如何在 C# 中创建不同的 PDF 版本;

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPdf 可根据文档特征自动管理 PDF 版本选择,选择从 1.4 到 1.7 的版本,以确保兼容性,同时保留功能。 这一无缝流程可处理从简单的 HTML 转换(通常为 PDF 1.4)到复杂的文档合并(PDF 1.7 标准)等各种情况。 在进行 PDF from HTML String 转换时,IronPDF 会根据您的内容要求智能地确定合适的版本。

as-heading:2(快速入门:用 C# 创建不同的 PDF 版本)

Nuget Icon立即开始使用 NuGet 创建 PDF 文件:

  1. 使用 NuGet 包管理器安装 IronPDF

    PM > Install-Package IronPdf

  2. 复制并运行这段代码。

    // Create a simple PDF using IronPDF - automatically selects version 1.4
    using IronPdf;
    
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");
    pdf.SaveAs("hello-world.pdf");
  3. 部署到您的生产环境中进行测试

    立即开始在您的项目中使用 IronPDF,免费试用!
    arrow pointer


如何创建 PDF 1.4 版文档?

<! -- 待办事项:在此处添加图片 --> <! --pdf 版本 1.4 示例实现示意图 --> <!--说明:说明代码概念的图表或截图 -->

IronPDF 支持从 1.2 到 1.7 的所有 PDF 版本。在将 HTML 转换为 PDF 时,IronPDF 会自动选择 Chromium 引擎提供的最低版本,范围从 PDF 1.4 到 PDF 1.6,以最大限度地提高兼容性。 这种行为与您在各种应用程序中导出不同 PDF 版本时发现的情况相匹配。

大多数转换的结果是 PDF 1.4。PDF 1.4 具有支持透明度的特点,可实现现代图形设计,同时保持广泛的兼容性。 在本例中,我们将使用 IronPDF 将 HTML 字符串转换为 PDF,以演示这种行为。 无论您是通过 HTML文件URL,还是 ASPX页面创建 PDF,这种方法都能无缝运行。

生成 PDF 1.4 需要哪些代码?

:path=/static-assets/pdf/content-code-examples/how-to/pdf-version-standard.cs
using IronPdf;

var renderer = new ChromePdfRenderer();

var pdf = renderer.RenderHtmlAsPdf("<p> Hello World!</p>");

pdf.SaveAs("output.pdf");
Imports IronPdf

Dim renderer As New ChromePdfRenderer()

Dim pdf = renderer.RenderHtmlAsPdf("<p> Hello World!</p>")

pdf.SaveAs("output.pdf")
$vbLabelText   $csharpLabel

IronPDF 的智能版本选择功能在此大放异彩。 对于没有高级功能的基本 HTML 内容,它默认使用 PDF 1.4,确保您的文档能在最广泛的 PDF 查看器和应用程序中运行。 在大多数情况下,这种自动选择功能无需手动配置版本。

PDF 1.4 输出是什么样的?

PDF 属性对话框显示 IronPdf v2025.9.18 为制作者和 PDF 1.4 版本(Acrobat 5.x)

如图所示,IronPDF 选择了其系列中的最低版本(PDF 1.4),以确保兼容性。 该版本支持字体嵌入、加密和基本表单等基本功能,同时与旧版 PDF 阅读器保持良好的兼容性。


如何创建 PDF 1.7 版文档?

IronPDF 在合并文档时会自动生成 PDF 1.7(国际标准),以确保最大的兼容性。 由于源 PDF 可能使用不同的版本和功能,因此默认使用全面的 1.7 标准可确保在不丢失数据的情况下保留所有原始元素。 这在合并或拆分来自不同来源的 PDF 时至关重要。

PDF 1.7 版已成为 ISO 标准 (ISO 32000-1:2008),并包含高级功能:

  • 增强安全性和加密选项
  • 3D 内容支持
  • 高级透明混合模式
  • 改进无障碍功能
  • 国际语言提供更好的 Unicode 支持

将 PDF 合并到 1.7 版需要哪些代码?

:path=/static-assets/pdf/content-code-examples/how-to/merge-or-split-pdfs-merge.cs
using IronPdf;

// Two paged PDF
const string html_a =
    @"<p> [PDF_A] </p>
    <p> [PDF_A] 1st Page </p>
    <div style = 'page-break-after: always;' ></div>
    <p> [PDF_A] 2nd Page</p>";

// Two paged PDF
const string html_b =
    @"<p> [PDF_B] </p>
    <p> [PDF_B] 1st Page </p>
    <div style = 'page-break-after: always;' ></div>
    <p> [PDF_B] 2nd Page</p>";

var renderer = new ChromePdfRenderer();

var pdfdoc_a = renderer.RenderHtmlAsPdf(html_a);
var pdfdoc_b = renderer.RenderHtmlAsPdf(html_b);

// Four paged PDF
var merged = PdfDocument.Merge(pdfdoc_a, pdfdoc_b);
merged.SaveAs("Merged.pdf");
Imports IronPdf

' Two paged PDF
Private Const html_a As String = "<p> [PDF_A] </p>
    <p> [PDF_A] 1st Page </p>
    <div style = 'page-break-after: always;' ></div>
    <p> [PDF_A] 2nd Page</p>"

' Two paged PDF
Private Const html_b As String = "<p> [PDF_B] </p>
    <p> [PDF_B] 1st Page </p>
    <div style = 'page-break-after: always;' ></div>
    <p> [PDF_B] 2nd Page</p>"

Private renderer = New ChromePdfRenderer()

Private pdfdoc_a = renderer.RenderHtmlAsPdf(html_a)
Private pdfdoc_b = renderer.RenderHtmlAsPdf(html_b)

' Four paged PDF
Private merged = PdfDocument.Merge(pdfdoc_a, pdfdoc_b)
merged.SaveAs("Merged.pdf")
$vbLabelText   $csharpLabel

在合并不同来源的文档或需要添加、复制或删除 PDF 页面时,这种合并功能至关重要。 最终生成的 PDF 1.7 文档将确保保留两个源文件的所有功能。

为什么 IronPDF 使用 1.7 版合并文档?

PDF 属性显示 IronPdf v2025.9.18 为制作者,PDF 版本为 1.7(兼容 Acrobat 8.x)

IronPDF 通过合并两个 PDF 生成了 1.7 版本的 PDF。 这将确保

1.通用兼容性:所有现代 PDF 阅读器和浏览器均支持 PDF 1.7 2.功能保留:保留源文件中的所有高级功能 3.面向未来:作为 ISO 标准,PDF 1.7 可确保文档的长期可访问性 4.增强安全性:支持高级PDF权限和密码

高级 PDF 版本注意事项

在 IronPDF 中处理 PDF 版本时,有几个因素会影响自动版本选择:

内容复杂性

包含基本文本和图像的简单 HTML 通常会生成 PDF 1.4 版本,而包含 JavaScript、表单或多媒体内容的文档可能会触发更高的版本。 当在您的 PDF 中执行自定义 JavaScript 时,IronPDF 可能会选择更高的版本来支持这些交互式功能。

功能要求

某些功能需要特定的 PDF 版本:

  • PDF 1.4:基本透明度、字体嵌入
  • PDF 1.5:层、对象流
  • PDF 1.6:OpenType 字体、3D 注释
  • PDF 1.7:增强安全性、软件包/组合功能

合规性和标准

出于存档目的,您可能需要特定的版本。 IronPDF 支持创建用于长期保存的 PDF/A 格式文件,这些文件根据所选的 PDF/A 级别有自己的版本要求。

性能优化

不同的 PDF 版本有不同的文件大小和处理要求。 PDF 1.4 文档通常较小,处理速度较快,因此非常适合大批量应用。 了解更多有关PDF压缩技术的信息,以优化您的文档。

通过了解这些版本差异并让 IronPDF 自动处理选择,您可以确保您的 PDF 在兼容性、功能和性能之间保持完美平衡,以满足您的特定用例。

常见问题解答

IronPDF 支持哪些 PDF 版本?

IronPDF 支持从 1.2 到 1.7 的所有 PDF 版本。在将 HTML 转换为 PDF 时,IronPDF 会根据您文档的特性自动选择合适的版本,通常会在 PDF 1.4 至 PDF 1.7 之间进行选择,以确保最佳兼容性。

IronPDF 如何确定使用哪个 PDF 版本?

IronPDF 可根据文档特征自动智能管理 PDF 版本选择。对于简单的 HTML 转换,它通常会选择 PDF 1.4,以获得最大的兼容性。对于文档合并等复杂操作,IronPDF 会使用 PDF 1.7 以保留所有功能。

我能否在创建文档时手动指定 PDF 版本?

IronPDF 可自动处理版本选择,在大多数情况下无需手动配置。该库可智能选择 Chromium 引擎提供的最低版本(从 PDF 1.4 到 PDF 1.6 不等),以支持您文档的所有功能。

将基本 HTML 转换为 PDF 时创建的 PDF 版本是什么?

在转换没有高级功能的基本 HTML 内容时,IronPDF 默认使用 PDF 1.4。该版本支持透明度、字体嵌入、加密和基本表单等基本功能,同时与旧版 PDF 阅读器保持良好的兼容性。

IronPDF 为何使用 PDF 1.7 进行文档合并?

IronPdf 在合并文档时会自动生成 PDF 1.7 版,以确保最大程度的兼容性,并保留源 PDF 的所有功能,因为源 PDF 可能使用不同的版本。PDF 1.7 是支持最广泛 PDF 功能的国际标准。

PDF 1.4 版支持哪些功能?

PDF 1.4 通常由 IronPDF 生成,用于 HTML 转换,其特点是支持透明度,可实现现代图形设计、字体嵌入、加密功能和基本表单功能。该版本在功能和兼容性之间实现了完美的平衡。

Curtis Chau
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位,专注于前端开发,精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外,Curtis 对物联网 (IoT) 有浓厚的兴趣,探索将硬件和软件集成的新方法。在空闲时间,他喜欢玩游戏和构建 Discord 机器人,将他对技术的热爱与创造力相结合。

准备开始了吗?
Nuget 下载 17,386,124 | 版本: 2026.2 刚刚发布