PDF 文檔通常是合同、發票、證書和報告的最終格式。盡管它們在設計上是靜態的，但用戶現在希望能夠與它們交互、驗證信息并直接從這些文件訪問數字服務。這時，二維碼就變得至關重要。
PDF 文檔中的二維碼將印刷或數字內容與動態在線體驗連接起來。用戶只需掃描二維碼即可驗證文檔、打開相關網站、訪問客戶門戶或繼續工作流程。在打印和共享文檔的環境中，二維碼可確保數字連接保持完整。
添加二維碼還能為物流和文檔管理帶來益處。例如，送貨單、采購訂單和訪客通行證可以包含可掃描的嵌入式信息。這使得公司能夠實現流程自動化并改進追蹤。在醫療保健和法律等行業，二維碼可以驗證真實性，并在不改變原始文檔布局的情況下引導用戶查看補充說明。
TX Text Control?提供兩種在 PDF 文檔中嵌入二維碼的主要方法。您可以使用 API 以編程方式添加二維碼，也可以創建帶有二維碼占位符的模板，并將其與 JSON 文件中的數據合并。根據具體應用，這兩種方法都提供了靈活性，可以滿足不同的需求。
TX Text Control 官方試用版最新下載
以編程方式添加二維碼
使用?TX Text Control?中的條形碼對象，開發人員可以直接創建二維碼并將其插入文檔。此方法可以完全控制二維碼的位置、大小和內容。
先決條件
您需要下載并安裝 TX Text Control .NET Server for ASP.NET 的試用版：
- 下載試用版
安裝程序需要下載和安裝。
創建應用程序
確保您下載了.NET 8 SDK附帶的最新版本的 Visual Studio 2022 。
-
在 Visual Studio 2022 中，選擇“創建新項目” 來創建新項目。
-
選擇Console App作為項目模板并單擊Next確認。
-
輸入項目名稱并選擇保存項目的位置。單擊“下一步”確認。
-
選擇.NET 8.0（長期支持）作為框架。
-
啟用啟用容器支持復選框并選擇Linux作為容器操作系統。
-
選擇Dockerfile作為容器構建類型選項，并通過創建進行確認。
添加 NuGet 包
-
在解決方案資源管理器中，選擇您創建的項目，然后從項目主菜單中選擇“管理 NuGet 包...”。選擇“文本控制離線包”作為包源。
安裝以下軟件包：
- TXTextControl.TextControl.Core.SDK
使用 ServerTextControl
-
在解決方案資源管理器中找到Program.cs文件，并將代碼替換為以下代碼片段：
using TXTextControl;
using TXTextControl.Barcode;
using TXTextControl.DataVisualization;
using System.Drawing;// Create a new ServerTextControl instance for server-side document generation
using var tx = new ServerTextControl();// Initialize a new, empty document
tx.Create();// The text to be encoded in the QR code
var barCodeText = "https://www.textcontrol.com";// Create the barcode core with type QR code and set the encoded text
var barcodeCore = new TXBarcodeCore
{BarcodeType = BarcodeType.QRCode,Text = barCodeText,UpperTextLength = barCodeText.Length // Optional visual setting
};// Create a frame for the barcode and define its visual size
var barcodeFrame = new BarcodeFrame(barcodeCore)
{Size = new Size(5000, 5000)
};// Add the barcode to the document at the end (-1 means current input position)
tx.Barcodes.Add(barcodeFrame, -1);// Save the document as a PDF
tx.Save("results.pdf", StreamType.AdobePDF);
-
現在運行在 Docker 容器中運行應用程序的項目。
這將創建一個 PDF 文檔，其中嵌入了指向給定網站的二維碼。
使用郵件合并
在許多商業應用中，將文檔的設計與數據分離至關重要。TX Text Control?允許模板包含二維碼占位符，這些占位符會在合并過程中填充動態內容。使用 TX Text Control 的編輯器可視化地設計這些模板。添加二維碼占位符并為其命名。
在文檔生成過程中，應用程序會加載模板并將其與 JSON 數據文件合并。JSON 對象中的值會自動應用于二維碼占位符。此方法非常適合批量處理任務，例如生成證書、會員卡或發票，這些任務中每個文檔都需要唯一的二維碼，但布局保持不變。
現在，我們來看一下開頭截圖中顯示的裝箱單示例。
使用?TX Text Control?的郵件合并?引擎創建此裝箱單非常簡單。首先，如下所示，我們需要一個數據源，例如 JSON 對象。
[{"packing_slip_guid": "12345678-1234-1234-1234-123456789012","dispatch_date": "2024-01-01","recipient": {"id": 1,"name": "John Doe","company": "Company A","address": {"street": "123 Main St","city": "Anytown","state": "CA","zip": "12345"}},"product": {"product_id": 1,"name": "Product 1","qty": "Product 1 Description","code": "123456789012"},"items": [{"item_id": 1,"name": "Item 1","description": "Description 1","quantity": 1,"price": 100,"upc": "12345678901"},{"item_id": 2,"name": "Item 2","description": "Description 2","quantity": 2,"price": 200,"upc": "12345678902"},{"item_id": 3,"name": "Item 3","description": "Description 3","quantity": 3,"price": 300,"upc": "12345678903"},[...]]}
]
我們需要一個包含合并字段和條形碼的模板文檔。合并字段將使用來自數據源的數據填充，條形碼將基于相同的數據生成。下方屏幕截圖顯示了?TX Text Control?的所見即所得 (WYSIWYG) 文檔編輯器中準備好的模板，該編輯器可以無縫集成到您的應用程序中。
條形碼可以鏈接到數據源字段，以便在最終文檔生成期間自動使用正確的值進行更新。
此代碼演示了如何使用?TX Text Control?的 MailMerge 類將動態 JSON 數據合并到預先設計的模板中來生成 PDF 文檔。
using TXTextControl;
using TXTextControl.DocumentServer;
using System.IO;// Create a new ServerTextControl instance for document processing
using var tx = new ServerTextControl();// Create a new, empty document
tx.Create();// Load the template document in TX Text Control's internal format
tx.Load("packing_slip.tx", StreamType.InternalUnicodeFormat);// Initialize the MailMerge component with the loaded document
var mailMerge = new MailMerge
{TextComponent = tx
};// Load JSON data from file
var jsonData = File.ReadAllText("data.json");// Merge the JSON data into the template
mailMerge.MergeJsonData(jsonData);// Save the merged document as a PDF
tx.Save("output.pdf", StreamType.AdobePDF);
結論
使用?TX Text Control，將二維碼添加到 PDF 文檔非常簡單。無論您是通過編程方式生成二維碼，還是結合模板使用郵件合并功能，該 API 的靈活性都讓您能夠創建動態的交互式文檔，從而提升用戶體驗并簡化工作流程。
二維碼和條形碼在各種文檔或 PDF 中都非常有用，它們提供了一種便捷的方式，可以訪問信息、驗證真偽、追蹤物品并增強用戶交互。本文介紹如何使用?TX Text Control .NET Server for ASP.NET?在 .NET C# 中創建帶有二維碼和條形碼的文檔。
