PDF 文檔通常是合同、發票、證書和報告的最終格式。盡管它們在設計上是靜態的，但用戶現在希望能夠與它們交互、驗證信息并直接從這些文件訪問數字服務。這時，二維碼就變得至關重要。

PDF 文檔中的二維碼將印刷或數字內容與動態在線體驗連接起來。用戶只需掃描二維碼即可驗證文檔、打開相關網站、訪問客戶門戶或繼續工作流程。在打印和共享文檔的環境中，二維碼可確保數字連接保持完整。

添加二維碼還能為物流和文檔管理帶來益處。例如，送貨單、采購訂單和訪客通行證可以包含可掃描的嵌入式信息。這使得公司能夠實現流程自動化并改進追蹤。在醫療保健和法律等行業，二維碼可以驗證真實性，并在不改變原始文檔布局的情況下引導用戶查看補充說明。

TX Text Control 提供兩種在 PDF 文檔中嵌入二維碼的主要方法。您可以使用 API 以編程方式添加二維碼，也可以創建帶有二維碼占位符的模板，并將其與 JSON 文件中的數據合并。根據具體應用，這兩種方法都提供了靈活性，可以滿足不同的需求。

TX Text Control 官方試用版最新下載

以編程方式添加二維碼

使用 TX Text Control 中的條形碼對象，開發人員可以直接創建二維碼并將其插入文檔。此方法可以完全控制二維碼的位置、大小和內容。

先決條件

您需要下載并安裝 TX Text Control .NET Server for ASP.NET 的試用版：

• 下載試用版
  安裝程序需要下載和安裝。

創建應用程序

確保您下載了附帶的最新版本的 Visual Studio 2022 。

1. 在 Visual Studio 2022 中，選擇“創建新項目” 來創建新項目。

2. 選擇Console App作為項目模板并單擊Next確認。

3. 輸入項目名稱并選擇保存項目的位置。單擊“下一步”確認。

4. 選擇.NET 8.0（長期支持）作為框架。

5. 啟用啟用容器支持復選框并選擇Linux作為容器操作系統。

6. 選擇Dockerfile作為容器構建類型選項，并通過創建進行確認。

   

添加 NuGet 包

1. 在解決方案資源管理器中，選擇您創建的項目，然后從項目主菜單中選擇“管理 NuGet 包...”。選擇“文本控制離線包”作為包源。

   安裝以下軟件包：

   • TXTextControl.TextControl.Core.SDK

   

使用 ServerTextControl

1. 在解決方案資源管理器中找到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 = "http://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);

1. 現在運行在 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# 中創建帶有二維碼和條形碼的文檔。

--------------------------------------------------------------------------

關于慧都

慧都科技是一家行業數字化解決方案公司，長期專注于軟件、油氣與制造行業。公司基于深入的業務理解與管理洞察，以系統化的業務建模驅動技術落地，幫助企業實現智能化運營與長期競爭優勢。在軟件工程領域，我們提供開發控件、研發管理、代碼開發、部署運維等軟件開發全鏈路所需的產品，提供正版授權采購、技術選型、個性化維保等服務，幫助客戶實現技術合規、降本增效與風險可控。慧都科技TX Text Control在中國的官方授權代理商，提供TX Text Control系列產品免費試用，咨詢，正版銷售等于一體的專業化服務。TX Text Control是文檔處理與管理領域的優秀產品，幫助企業實現高效的文檔開發。