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 让这一切变得简单：生成一个 QrWriter.Write 格式的 QR 码，并通过一次 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 文件，请使用 QrWriter.Write 生成 QR 码，并使用 Save() 将其保存为 AnyBitmap 文件。 使用 PdfDocument.FromFile 加载目标 PDF，然后使用 DrawBitmap 将 QR 码放置在精确坐标位置。 x 和 y 值以 PDF 点为单位（A4 页面为 595 × 842 点），而 desiredWidth 和 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;
using IronPdf;
using IronSoftware.Drawing;

// Generate QR code bitmap
AnyBitmap qrBitmap = QrWriter.Write("hello world").Save();

// Load the existing PDF
PdfDocument pdf = PdfDocument.FromFile("sample.pdf");

// Stamp the QR code at the top-right corner of page 1
// A4 page is 595 x 842 PDF points; x:505, y:20 places a 70pt QR near the top-right
pdf.DrawBitmap(qrBitmap, 0, 505, 20, 70, 70);

pdf.SaveAs("sample.pdf");

Imports IronQr
Imports IronPdf
Imports IronSoftware.Drawing

' Generate QR code bitmap
Dim qrBitmap As AnyBitmap = QrWriter.Write("hello world").Save()

' Load the existing PDF
Dim pdf As PdfDocument = PdfDocument.FromFile("sample.pdf")

' Stamp the QR code at the top-right corner of page 1
' A4 page is 595 x 842 PDF points; x:505, y:20 places a 70pt QR near the top-right
pdf.DrawBitmap(qrBitmap, 0, 505, 20, 70, 70)

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

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

输出

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

控制位置和页码

x 和 y 参数以 PDF 点为单位，从页面左上角开始测量。 增加 x 会将水印向右移动； 增加 y 会将其下移。 pageIndex 参数采用从零开始的计数方式，因此 pageIndex: 0 指向第一页。

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

输入

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

QR code encoding https://ironsoftware.com/verify

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

QR code encoding 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;
using IronPdf;
using IronSoftware.Drawing;

PdfDocument pdf = PdfDocument.FromFile("document.pdf");

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

// Page 2: stamp a support QR at the bottom-left corner
AnyBitmap qrSupport = QrWriter.Write("https://ironsoftware.com/support").Save();
pdf.DrawBitmap(qrSupport, 1, 20, 752, 70, 70);

pdf.SaveAs("document.pdf");

Imports IronQr
Imports IronPdf
Imports IronSoftware.Drawing

Dim pdf As PdfDocument = PdfDocument.FromFile("document.pdf")

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

' Page 2: stamp a support QR at the bottom-left corner
Dim qrSupport As AnyBitmap = QrWriter.Write("https://ironsoftware.com/support").Save()
pdf.DrawBitmap(qrSupport, 1, 20, 752, 70, 70)

pdf.SaveAs("document.pdf")
$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 码前进行更多控制（例如设置纠错级别或调整输出尺寸），请配置 QrOptions 对象，并在调用 StampToExistingPdfPage 之前将其传递给 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 下载 67,270 | 版本: 2026.5 just released
Still Scrolling Icon

还在滚动吗？

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