使用 GroupDocs.Signature for .NET 掌握 PDF 中的二維碼搜尋

介紹

您是否希望透過高效管理嵌入式二維碼來增強 PDF 文件的安全性和真實性？本教學將逐步說明如何使用 GroupDocs.Signature for .NET，將二維碼搜尋功能無縫整合到您的文件管理系統中。

在當今的數位時代，保護和驗證文件簽名至關重要。透過 GroupDocs.Signature for .NET，您可以輕鬆實現二維碼搜索，以確保資料完整性並簡化工作流程。本指南將指導您初始化簽名對象、設定加密、配置搜尋選項以及在 PDF 中執行搜尋。

您將學到什麼：

如何在應用程式中初始化簽名對象
設定對稱資料加密以保護敏感資訊
配置適合您需求的二維碼搜尋選項
在 PDF 文件中執行二維碼簽名搜索

先決條件

在開始之前，請確保您擁有以下工具和知識：

所需的庫和版本：

GroupDocs.簽名：本教學使用的核心庫。請確保已透過 NuGet 安裝。

環境設定要求：

您的機器上設定了 .NET Core 或 .NET Framework 環境。

知識前提：

對 C# 程式設計有基本的了解
熟悉文件處理概念

為 .NET 設定 GroupDocs.Signature

若要開始使用 GroupDocs.Signature，請在專案中安裝該程式庫。操作方法如下：

使用 .NET CLI：

dotnet add package GroupDocs.Signature

使用套件管理器：

Install-Package GroupDocs.Signature

或者，使用 NuGet 套件管理器 UI 搜尋“GroupDocs.Signature”並安裝它。

許可證取得步驟

免費試用：從免費試用開始探索功能。
臨時執照：在開發期間請求臨時許可證以延長存取權限。
購買：如果 GroupDocs.Signature 滿足您的需求，請考慮購買。

安裝後，如下初始化庫：

using GroupDocs.Signature;

string filePath = Path.Combine("YOUR_DOCUMENT_DIRECTORY", "SAMPLE_PDF_QRCODE_ENCRYPTED_TEXT");
using (Signature signature = new Signature(filePath))
{
    // 簽章物件現已準備好進行進一步的操作。
}

實施指南

讓我們將實現分解為以下幾個主要特徵：

初始化簽名對象

第一步是創建一個 Signature 實例，它是處理文件的基礎。

using GroupDocs.Signature;
using System.IO;

string filePath = Path.Combine("YOUR_DOCUMENT_DIRECTORY", "SAMPLE_PDF_QRCODE_ENCRYPTED_TEXT");

// 使用檔案路徑作為輸入建立 Signature 類別的實例。
using (Signature signature = new Signature(filePath))
{
    // 簽名物件現在可以進行進一步的操作，例如搜尋或新增簽名。
}

要點：

Signature 類別充當文檔處理任務的容器。
確保您的文件路徑正確指向目標 PDF。

設定資料加密

為了保護資料安全，我們使用 Rijndael 演算法進行對稱加密。您可以按照以下方法進行配置：

using GroupDocs.Signature.Domain;

// 定義加密的密鑰和鹽。
string key = "1234567890";
string salt = "1234567890";

// 建立 SymmetricEncryption 的實例，並指定 Rijndael 為演算法類型。
IDataEncryption encryption = new SymmetricEncryption(SymmetricAlgorithmType.Rijndael, key, salt);

// 加密物件現已配置並可用於加密資料。

要點：

SymmetricEncryption 提供一種安全的方法來保護敏感資訊。
自訂 key 和 salt 根據您的安全要求。

配置二維碼搜尋選項

若要在文件中搜尋二維碼，請配置特定的搜尋選項：

using GroupDocs.Signature.Options;

QrCodeSearchOptions options = new QrCodeSearchOptions()
{
    AllPages = true,
    PageNumber = 1,
    PagesSetup = new PagesSetup() { FirstPage = true, LastPage = true, OddPages = false, EvenPages = false },
    EncodeType = QrCodeTypes.QR,
    DataEncryption = encryption
};

// 選項物件現已準備好，其中包含用於在文件中搜尋二維碼的指定設定。

要點：

AllPages 設定為 true 可確保搜尋覆蓋每個頁面。
調整 PageNumber 和 PagesSetup 根據需要。

搜尋文檔中的二維碼簽名

最後，執行搜尋操作，尋找二維碼簽章：

using System;
using System.Collections.Generic;

try
{
    // 使用指定的二維碼搜尋選項對文件執行搜尋操作。
    List<QrCodeSignature> signatures = signature.Search<QrCodeSignature>(options);
    
    Console.WriteLine("\nSource document contains following signatures.");
    foreach (var qrCodeSignature in signatures)
    {
        Console.WriteLine("QRCode signature found at page {0} with type {1} and text '{2}'", 
            qrCodeSignature.PageNumber, 
            qrCodeSignature.EncodeType.TypeName, 
            qrCodeSignature.Text);
    }
}
catch (Exception ex)
{
    Console.WriteLine($"\nAn error occurred: {ex.Message}");
}

要點：

使用 signature.Search 定位二維碼簽名。
處理異常以管理搜尋過程中的任何錯誤。

實際應用

在 PDF 中整合二維碼搜尋功能可以在各種場景中發揮作用：

合約管理：快速驗證合約中嵌入為二維碼的數位簽章。
發票處理：自動識別儲存在二維碼中的發票詳細信息，以便加快處理速度。
安全文件共享：透過加密二維碼內的資料並驗證其完整性來增強安全性。

性能考慮

為了優化使用 GroupDocs.Signature 時的效能：

資源管理：確保您的應用程式有效地管理內存，尤其是大型文件。
優化搜尋選項：自訂搜尋選項以盡量減少不必要的處理，只專注於相關頁面或部分。
定期更新：保持庫處於最新狀態，以從效能改進和新功能中受益。

結論

透過學習本教程，您現在已經掌握了使用 GroupDocs.Signature for .NET 在 PDF 中實現二維碼搜尋功能的堅實基礎。掌握這些技能後，您可以增強文件安全性並簡化工作流程。

後續步驟：

嘗試不同的加密演算法。
探索 GroupDocs.Signature 提供的附加功能，以進一步豐富您的應用程式。

準備好踏出下一步了嗎？深入了解 GroupDocs.Signature 的功能，為您的專案開啟新的可能性！

常見問題部分

GroupDocs.Signature for .NET 用於什麼？
- 它是一個用於管理文件中的數位簽章的綜合庫，支援包括 PDF 在內的各種格式。
如何處理帶有二維碼的大型 PDF 文件？
- 優化搜尋設定以專注於特定頁面或部分並確保高效的記憶體管理。
GroupDocs.Signature 可以支援其他加密演算法嗎？
- 是的，它支援多種對稱和非對稱加密方法。
如果我的二維碼搜尋失敗，該怎麼辦？
- 驗證搜尋選項的配置並檢查文件格式或內容中是否有任何錯誤。
如何將 GroupDocs.Signature 與其他系統整合？
- 利用其 API 連接各種文件管理平台，增強跨不同環境的互通性。