使用 GroupDocs.Signature for .NET 簽署帶有二維碼的 PDF：綜合指南

介紹

在當今的數位世界中，安全地簽署 PDF 文件對於維護其真實性和完整性至關重要。透過 GroupDocs.Signature for .NET，您可以將二維碼無縫嵌入到 PDF 文件中，進行數位簽名，同時確保自訂資料序列化。本指南將指導您如何使用二維碼進行安全加密的文件簽章。

您將學到什麼：

如何為 .NET 設定和配置 GroupDocs.Signature。
在文件簽章中實現自訂資料序列化。
使用具有安全加密的二維碼簽章簽署文件。

首先讓我們回顧一下開始之前需要滿足的先決條件。

先決條件

在開始之前，請確保您已準備好以下事項：

所需的庫和依賴項

適用於 .NET 的 GroupDocs.Signature：用於文件簽名的主要庫。

環境設定要求

能夠運行.NET 應用程式的開發環境（例如 Visual Studio）。

知識前提

對 C# 程式語言有基本的了解。
熟悉資料序列化和加密等概念。

為 .NET 設定 GroupDocs.Signature

要開始使用 GroupDocs.Signature，您需要將其安裝到您的專案中。根據您的開發設置，以下是可用的方法：

使用 .NET CLI：

dotnet add package GroupDocs.Signature

使用套件管理器控制台：

Install-Package GroupDocs.Signature

使用 NuGet 套件管理器 UI：

搜尋“GroupDocs.Signature”並安裝最新版本。

許可證獲取

您可以先免費試用，也可以申請臨時許可證來探索所有功能。如果您希望繼續使用，可以考慮購買完整許可證：

免費試用：下載免費試用版
臨時執照：申請臨時許可證
購買：立即購買

基本初始化和設定

安裝完成後，首先在 C# 專案中匯入必要的命名空間：

using GroupDocs.Signature;
using GroupDocs.Signature.Options;

初始化 Signature 類別與您的文件路徑一起準備簽名。

實施指南

本節將引導您使用 GroupDocs.Signature for .NET 實作兩個關鍵功能：自訂資料序列化和基於二維碼的文件簽章。

特性1：自訂資料序列化對象

概述

自訂資料序列化方式，讓您能夠自訂簽名中嵌入的資訊結構。這種靈活性對於滿足特定業務或合規性要求至關重要。

實施步驟

1. 定義自訂序列化類 首先建立一個用於保存簽名資料的類別。使用 GroupDocs.Signature 中的屬性來定義序列化格式：

using System;
using GroupDocs.Signature.Domain.Extensions;

[CustomSerialization]
private class DocumentSignatureData
{
    [Format("SignID")]
    public string ID { get; set; }

    [Format("SAuth")]
    public string Author { get; set; }

    [Format("SDate", "yyyy-MM-dd")]
    public DateTime Signed { get; set; }

    [Format("SDFact", "N2")]
    public decimal DataFactor { get; set; }
}

解釋：

CustomSerialization 屬性表示此類將用於自訂序列化。
這 Format 屬性指定在序列化輸出中每個屬性的格式。

功能二：二維碼簽名文檔

概述

在文件中嵌入二維碼，可以提供一種緊湊、安全的方式來儲存簽名資料。此功能示範如何在流程中新增自訂資料和加密。

實施步驟

1.準備你的環境 確保您已定義輸入和輸出文件的路徑：

string filePath = "YOUR_DOCUMENT_DIRECTORY"; // 文檔目錄的路徑
string outputFilePath = Path.Combine("YOUR_OUTPUT_DIRECTORY", "SignWithQRCodeSecureCustom", "QRCodeCustomSerializationObject.pdf");

2.初始化簽名對象 建立一個實例 Signature 文件路徑為：

using (Signature signature = new Signature(filePath))
{
    // 繼續簽署文件
}

3.配置自訂資料和加密 實例化您的自訂序列化物件並應用加密：

IDataEncryption encryption = new CustomXOREncryption();

DocumentSignatureData documentSignatureData = new DocumentSignatureData()
{
    ID = Guid.NewGuid().ToString(),
    Author = Environment.UserName,
    Signed = DateTime.Now,
    DataFactor = 11.22M
};

4. 設定二維碼簽名選項 配置二維碼簽名選項：

QrCodeSignOptions options = new QrCodeSignOptions()
{
    Data = documentSignatureData,
    EncodeType = QrCodeTypes.QR,
    DataEncryption = encryption,
    Height = 100,
    Width = 100,
    VerticalAlignment = VerticalAlignment.Center,
    HorizontalAlignment = HorizontalAlignment.Left,
    Margin = new Padding() { Right = 10, Bottom = 10 }
};

5.執行簽名流程 最後，簽署您的文件並儲存：

signature.Sign(outputFilePath, options);

故障排除提示

確保所有路徑都設定正確，以避免檔案未找到異常。
驗證您的加密方法是否與二維碼要求相容。

實際應用

此解決方案可以應用於各種場景，例如：

法律合約：將簽名資料嵌入法律文件中，以便於驗證。
庫存管理：將序列化產品資訊安全地儲存在運輸標籤上。
活動門票：使用加密的二維碼保護門票真實性和參與者詳細資料。

性能考慮

處理大量文件時，請考慮透過以下方式優化效能：

有效地管理記憶體：當不再需要物件時將其丟棄。
盡可能使用非同步方法來防止阻塞操作。

結論

在本教學中，我們探討如何利用 GroupDocs.Signature for .NET 來使用二維碼對 PDF 進行簽名，同時融入自訂資料序列化功能。請依照以下步驟操作，您可以增強文件簽章流程的安全性和完整性。您可以考慮探索 GroupDocs.Signature 提供的更多功能，以便在您的專案中充分利用其功能。

常見問題部分

Q：什麼是自訂資料序列化？ 答：它是一種將資料轉換為特定格式進行儲存或傳輸的方法，以滿足獨特的要求。

Q：我可以將其他類型的簽章與 GroupDocs.Signature 一起使用嗎？ 答：是的，它支援各種簽名類型，包括文字、圖像、數位憑證等。

Q：加密如何增強二維碼簽章？ 答：加密可確保二維碼內的資料不會受到未經授權的存取或竄改。

Q：簽署文件時常見問題有哪些？ 答：常見問題包括文件路徑錯誤和文件格式不受支援。請務必確保輸入檔相容。

Q：在哪裡可以找到更多關於 GroupDocs.Signature for .NET 的資源？ 答：訪問 GroupDocs 文檔並透過他們的 API 參考和支援論壇進一步探索。