1. IronQR
  2. 操作指南
  3. 將QR碼蓋章到PDF

如何將 QR code 生成後嵌入 PDF 頁面

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

將 QR 碼直接嵌入 PDF 文件中，即可立即為頁面添加浮水印，或加入 URL、追蹤 ID 或數位簽章等動態資訊。

在現有 PDF 中加入 QR 碼是文件工作流程中常見的需求。 發票 PDF 檔中可能包含一個連結至付款入口網站的 QR 碼。 政府紀錄中可能嵌入驗證碼。 活動門票可包含可掃描的識別碼，無需重新調整整個文件的版面配置。 IronQR 讓這一切變得簡單：使用 QrWriter.Write 生成 QR 碼，並透過單一呼叫 DrawBitmap 將其標記在任何頁面的任意位置。

本指南將示範如何使用 IronQR程式庫，將 QR 碼嵌入現有的 PDF 檔案中。 尚未生成 QR 碼的開發人員，請先參閱《將 QR 碼儲存為圖片》指南。

快速入門：在 PDF 中嵌入 QR 碼

生成一個 QR 碼，並將其蓋印在現有 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# 程式庫，將 QR 碼嵌入 PDF 檔案
  2. 使用 `QrWriter.Write().Save()` 產生 QR 碼位圖
  3. 使用 `PdfDocument.FromFile()` 載入 PDF
  4. 呼叫 `DrawBitmap()` 時，需傳入頁面索引、x/y 座標及大小
  5. 使用 `SaveAs()` 儲存修改後的 PDF

將 QR 碼加印至 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 文件中。

QR 碼位圖編碼 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。 為避免覆寫原始檔案，請傳入不同的輸出路徑。

輸出

QR 碼位於第 1 頁右上角，座標為 (505, 20)，尺寸為 70 × 70 PDF 點。

控制位置與頁碼

x 和 y 參數以 PDF 點為單位，從頁面的左上角開始測量。 增加 x 會將水印向右移動； 增加 y 會將其向下移動。 pageIndex 參數採用零起始計數，因此 pageIndex: 0 對應的第一頁。

以下範例將兩個 QR 碼分別印製在不同頁面上——第 1 頁右上角為驗證連結，第 2 頁左下角為支援連結：

輸入

下方的兩個 QR 碼分別編碼了驗證與支援網址，這些連結將被印製在不同的頁面中。

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

第 1 頁輸入內容 — ironsoftware.com/verify 的 QR 碼

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

第 2 頁輸入內容 — ironsoftware.com/support 的 QR 碼 

: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 的 QR 碼，請從頁面寬度中減去 QR 碼尺寸與邊距：x = 595 − 70 − 20 = 505，並保持 y = 20 使其位於頁面頂部附近。 若要將 QR 碼置於左下角，x = 20，並從頁面高度中減去：y = 842 − 70 − 20 = 752。

輸出

每個 QR 碼皆置於對應的角落位置——驗證碼位於第 1 頁右上角，支援碼位於第 2 頁左下角。

使用案例

  • 發票付款連結：將付款入口網站的 URL 進行編碼，並將其置於第 1 頁的右上角，以便客戶掃描後立即付款。
  • 文件驗證：將記錄 ID 或雜湊值進行編碼，並將其標記在每頁底部，以便收件者驗證真實性。
  • 活動門票：請將參加者 ID 或預訂編號編碼後，印於第 1 頁中央，以便於入場時掃描。
  • 產品標籤：將產品網址或序號編碼後，標記於左上角或右下角，以便快速查詢庫存。
  • 法律文件：編碼案件編號或提交參考編號，並將其加蓋於每頁頁尾以利追蹤。

若需在印製前對 QR 碼進行更多控制(例如設定錯誤校正等級或調整輸出尺寸)，請先設定 QrOptions 物件，並在呼叫 StampToExistingPdfPage 之前將其傳遞給 QrWriter.Write。

如需更多 QR 碼生成範例，請參閱 C# QR 碼生成器教學，並探索 IronQR 的完整功能集。

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位，專注於前端開發，擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面，喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外，Curtis 對物聯網 (IoT) 有著濃厚的興趣，探索將硬體和軟體結合的創新方式。在閒暇時間，他喜愛遊戲並構建 Discord 機器人，結合科技與創意的樂趣。

準備好開始了嗎？
Nuget 下載 63,625 | 版本： 2026.4 剛剛發布
Still Scrolling Icon

還在捲動嗎？

想要快速證明？ PM > Install-Package IronQR
執行範例 觀看您的 URL 變成 QR code。