1. IronQR
  2. 操作指南
  3. 将QR码盖到PDF

如何在 PDF 页面中添加二维码

Curtis Chau
Curtis Chau
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

将二维码直接嵌入 PDF 文档，即可即时为页面添加水印，或插入 URL、跟踪 ID 或数字签名等动态信息。

在现有 PDF 中添加二维码是文档工作流中的常见需求。 发票 PDF 文件中可能包含一个链接至支付门户的二维码。 政府记录中可能包含验证码。 活动门票可在不改变整个文档布局的情况下包含可扫描的身份证件信息。 IronQR让这一切变得简单明了：使用DrawBitmap一次调用将其盖印到任意页面的任意位置。

本指南演示了如何使用 IronQR库将二维码嵌入到现有的 PDF 文件中。 尚未生成二维码的开发者，请先参阅《将二维码生成图片》指南。

快速入门：在 PDF 中嵌入二维码

生成一个二维码，并将其印在现有 PDF 页面的特定位置。

  1. 使用 NuGet 包管理器安装 https://www.nuget.org/packages/IronQR

    PM > Install-Package IronQR

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

    var qrBitmap = QrWriter.Write("https://example.com").Save();
var pdf = PdfDocument.FromFile("document.pdf");
pdf.Pages[0].DrawBitmap(qrBitmap, 505, 20, 70, 70);
pdf.SaveAs("stamped.pdf");

  3. 部署到您的生产环境中进行测试

    通过免费试用立即在您的项目中开始使用IronQR

    arrow pointer

最小工作流程（5 个步骤）

  1. 下载 IronQR C# 库，将二维码嵌入 PDF 文件
  2. 使用 QrWriter.Write().Save() 生成 QR 码位图
  3. 使用 PdfDocument.FromFile() 加载 PDF
  4. 调用 DrawBitmap() 时需传入页面索引、x/y 坐标及尺寸
  5. 使用 SaveAs() 保存修改后的 PDF

在 PDF 页面上添加二维码

要将QR码嵌入到现有PDF中，使用AnyBitmap。 使用DrawBitmap将QR码放置在精确的坐标上。 x和y的值是以PDF点为单位的（A4页面为595 × 842点），而desiredHeight控制盖印的大小。

输入

下方的QR码编码了https://ironsoftware.com，并将盖印到PDF上。

二维码位图编码 https://ironsoftware.com 
:path=/static-assets/qr/content-code-examples/how-to/stamp-qr-code-to-pdf.cs
using IronQr;

// Generate the QR code
QrCode myQr = QrWriter.Write("hello world");

// Stamp the QR code at the top-right corner of page 1 (zero-based pageIndex)
// A4 page is 595 x 842 PDF points; x:505, y:20 places the QR near the top-right.
// The final parameter is the PDF password ("" for unencrypted files).
myQr.StampToExistingPdfPage("sample.pdf", 505, 20, 0, "");

Imports IronQr

' Generate the QR code
Dim myQr As QrCode = QrWriter.Write("hello world")

' Stamp the QR code at the top-right corner of page 1 (zero-based pageIndex)
' A4 page is 595 x 842 PDF points; x:505, y:20 places the QR near the top-right.
' The final parameter is the PDF password ("" for unencrypted files).
myQr.StampToExistingPdfPage("sample.pdf", 505, 20, 0, "")
$vbLabelText   $csharpLabel

修改后的PDF会通过SaveAs保存。 为避免覆盖源文件，请指定不同的输出路径。

输出

二维码位于第 1 页右上角，坐标为 (505, 20)，尺寸为 70 × 70 PDF 点。

控制位置和页码

y参数是从页面左上角开始测量的PDF点。 增加x将盖印移向右侧； 增加y将其向下移动。 pageIndex: 0目标是第一页。

以下示例在不同页面上添加了两个二维码——页面 1 的右上角为验证链接，页面 2 的左下角为支持链接：

输入

下方的两个二维码分别编码了验证和支持网址，这些网址将被印在不同的页面上。

编码 https://ironsoftware.com/verify 的二维码

第 1 页输入内容 — ironsoftware.com/verify 的二维码

编码 https://ironsoftware.com/support 的二维码

第 2 页输入 — ironsoftware.com/support 的二维码 

:path=/static-assets/qr/content-code-examples/how-to/stamp-qr-code-to-pdf-positions.cs
using IronQr;

// Page 1: stamp a verification QR at the top-right corner (pageIndex 0)
QrCode qrVerify = QrWriter.Write("https://ironsoftware.com/verify");
qrVerify.StampToExistingPdfPage("document.pdf", 505, 20, 0, "");

// Page 2: stamp a support QR at the bottom-left corner (pageIndex 1)
QrCode qrSupport = QrWriter.Write("https://ironsoftware.com/support");
qrSupport.StampToExistingPdfPage("document.pdf", 20, 752, 1, "");

Imports IronQr

' Page 1: stamp a verification QR at the top-right corner (pageIndex 0)
Dim qrVerify As QrCode = QrWriter.Write("https://ironsoftware.com/verify")
qrVerify.StampToExistingPdfPage("document.pdf", 505, 20, 0, "")

' Page 2: stamp a support QR at the bottom-left corner (pageIndex 1)
Dim qrSupport As QrCode = QrWriter.Write("https://ironsoftware.com/support")
qrSupport.StampToExistingPdfPage("document.pdf", 20, 752, 1, "")
$vbLabelText   $csharpLabel

请注意PDF 点是 PDF 页面上坐标的测量单位。 A4 页面的宽度为 595 点，高度为 842 点，左上角坐标为 (0, 0)。 若要在右上角边缘留出 20 pt 边距处放置一个 70 pt 的二维码，需从页面宽度中减去二维码尺寸和边距：x = 595 − 70 − 20 = 505，并将 y 值设为 20 以使其位于页面顶部附近。 对于左下角，x = 20，然后从页面高度中减去：y = 842 − 70 − 20 = 752。）））

输出

每个二维码均放置在对应角落——验证码位于第 1 页右上角，支持信息位于第 2 页左下角。

用例

  • 发票支付链接：将支付门户网址编码后，将其嵌入第 1 页的右上角，以便客户扫描并立即付款。
  • 文档验证：将记录 ID 或哈希值编码后，将其作为水印添加在每页底部，以便接收方验证真实性。
  • 活动门票：请在第 1 页中央印上参会者 ID 或预订编号，以便入场时轻松扫描。
  • 产品标签：将产品 URL 或序列号编码后，将其印在左上角或右下角，以便快速查询库存。
  • 法律记录：编码案件编号或提交参考号，并将其加盖在每页页脚以确保可追溯性。

为了在盖印QR码之前获得更多控制，例如设置纠错等级或调整输出大小，请配置QrWriter.Write。

如需了解更多二维码生成模式，请参阅 C# 二维码生成器教程以及 IronQR 的完整功能集。

常见问题解答

什么是 IronQR？

IronQR是一个功能强大的库，能够在.NET应用中生成和操作QR码，允许您创建、定制和将QR码集成到多种文档格式中，包括PDF。

如何使用IronQR在现有PDF中嵌入QR码？

您可以使用IronQR的QrWriter.Write方法来生成QR码，然后使用StampToExistingPdfPage函数将其印在特定坐标的PDF页面上来嵌入QR码。

StampToExistingPdfPage函数是什么？

IronQR中的StampToExistingPdfPage函数允许您将QR码精确地放置在现有PDF页面的特定位置，使您能够为文档加水印或无缝添加动态数据。

IronQR可以用来给文档加水印吗？

是的，IronQR可以通过将QR码印在PDF页面上来给文档加水印。此功能可用于向文档添加动态信息或品牌标识。

在PDF中使用IronQR进行QR码集成的优势是什么？

IronQR提供了易于使用的方法来生成和印制QR码到PDF中，允许对QR码的放置和定制进行精确控制，是为文档添加动态内容的理想选择。

在嵌入到PDF之前可以定制QR码吗？

是的，使用IronQR，您可以在将QR码印到PDF页面之前自定义QR码的各个方面，例如尺寸、颜色和纠错级别。

IronQR支持PDF的动态QR码生成吗？

IronQR支持动态QR码生成，允许创建的QR码可以印在PDF文档中并包含最新信息，适合需要实时数据更新的场景。

将QR码印入PDF需要哪种编程语言？

IronQR设计用于C#，为开发人员提供了一个强大的库，可以将QR码功能集成到.NET应用中，包括在PDF文件中印入QR码。

如何在IronQR中指定QR码在PDF中的放置坐标？

在IronQR中，您可以使用StampToExistingPdfPage函数在PDF页面上指定QR码的精确放置坐标，确保您的QR码定位准确。

Curtis Chau
Curtis Chau
  立即与工程团队聊天
技术作家

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

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

准备开始了吗？
Nuget 下载 70,398 | 版本: 2026.7 刚刚发布
Still Scrolling Icon

还在滚动吗？

想快速获得证据？ PM > Install-Package IronQR
运行示例 观看您的 URL 变成 QR 代码。