如何使用 GroupDocs.Signature for .NET 對具有元資料的 PDF 文件進行簽名

在當今的數位世界中，高效管理文件對於企業和個人都至關重要。安全地簽署和驗證文件已變得至關重要，尤其是在處理合約或官方記錄時。本指南將示範如何使用 GroupDocs.Signature for .NET 對 PDF 文件進行元資料簽名，從而增強文件的完整性。

您將學到什麼

在您的專案中為 .NET 設定 GroupDocs.Signature。
使用元資料簽章簽署 PDF 文件的逐步指南。
搜尋和驗證簽名文件中現有元資料簽章的方法。
該技術在現實場景中的實際應用。

在開始之前，請確保您擁有學習本教學所需的工具。

先決條件

要遵循本教程，您需要：

開發環境：您的機器上安裝了 .NET Core SDK 或 .NET Framework。
適用於 .NET 的 GroupDocs.Signature：確保您擁有最新版本的 GroupDocs.Signature 庫。您可以透過 NuGet 套件管理器、.NET CLI 或 NuGet 套件管理器 UI 來安裝它。
.NET CLI
```
dotnet add package GroupDocs.Signature
```
套件管理器控制台
```
Install-Package GroupDocs.Signature
```
知識：熟悉 C# 程式設計並對 .NET 專案設定有基本的了解。

為 .NET 設定 GroupDocs.Signature

首先，請按照以下步驟將 GroupDocs.Signature 整合到您的 .NET 應用程式中：

安裝：
- 使用上面提到的方法（NuGet 套件管理器或 CLI）將 GroupDocs.Signature 新增到您的專案中。
許可證獲取：
- 取得臨時許可證或從 GroupDocs 網站解鎖所有功能。
基本初始化：首先設定你的環境並初始化 Signature 對象，它是使用 GroupDocs.Signature for .NET 的核心。

using System;
using GroupDocs.Signature;

string filePath = "YOUR_DOCUMENT_DIRECTORY"; // PDF 檔案的路徑

實施指南

使用元資料簽章簽署文檔

概述

此功能可讓您將元資料嵌入到已簽署的文件中。元資料可以包含作者姓名、建立日期以及其他與您的需求相關的自訂資料。

實施步驟

步驟1：初始化簽名對象

using (Signature signature = new Signature(filePath))
{
    // 準備元資料的簽章選項
}

這將初始化一個 Signature 物件與文檔的文件路徑。 using 語句確保資源在使用後得到適當處置。

第 2 步：建立元資料簽章選項

MetadataSignOptions signOptions = new MetadataSignOptions();
signOptions.Add(new PdfMetadataSignature("Author", "Mr.Sherlock Holmes")); // 新增作者姓名
signOptions.Add(new PdfMetadataSignature("CreatedOn", DateTime.Now));       // 目前日期和時間
signOptions.Add(new PdfMetadataSignature("DocumentId", 123456));            // 唯一文檔ID
signOptions.Add(new PdfMetadataSignature("SignatureId", 123.456D));         // 簽名標識符為雙重
signOptions.Add(new PdfMetadataSignature("Amount", 123.456M));              // 十進制格式的金額
signOptions.Add(new PdfMetadataSignature("Total", 123.456F));               // 總金額（浮點數）

在這裡，我們創建一個 MetadataSignOptions 物件並添加具有不同資料類型的各種元資料簽章。

步驟3：簽署文件

string outputFilePath = Path.Combine("YOUR_OUTPUT_DIRECTORY", "SignedWithMetadata.pdf");
SignResult signResult = signature.Sign(outputFilePath, signOptions);

foreach (BaseSignature temp in signResult.Succeeded)
{
    Console.WriteLine($"Signature ID: {temp.SignatureId}");
}

此步驟使用指定的元資料對文件進行簽名並將其儲存到新文件中。 signResult 物件保存有關簽名過程的資訊。

搜尋文件中的元資料簽名

概述

簽名後，您可能需要驗證或搜尋 PDF 文件中的現有元資料。

實施步驟

步驟1：初始化簽名對象

using (Signature signature = new Signature(outputFilePath))
{
    // 搜尋元資料簽名
}

重新初始化 Signature 指向簽名文檔路徑的物件。

步驟 2：搜尋元資料簽名

List<PdfMetadataSignature> signatures = signature.Search<PdfMetadataSignature>(SignatureType.Metadata);

foreach (PdfMetadataSignature mdSignature in signatures)
{
    Console.WriteLine($"\t[{mdSignature.TagPrefix} : {mdSignature.Name}] = {mdSignature.Value} ({mdSignature.Type})");
}

這將搜尋文件中的所有元資料簽名，並將其詳細資訊列印到控制台。

實際應用

合約管理：在法律文件中自動嵌入作者和時間戳資訊。
發票處理：將唯一識別碼和財務資料直接包含在發票中。
審計線索：透過嵌入詳細的元資料來維護全面的審計追蹤以用於追蹤目的。
與 CRM 系統集成：將文件簽章工作流程無縫整合到客戶關係管理平台。

性能考慮

使用高效的資料類型並盡量減少資源密集型操作以優化效能。
有效地管理內存，尤其是在處理大型文件或大量文件時。
遵循 .NET 應用程式的最佳實務以確保順利運行。

結論

到目前為止，您應該已經深入了解如何使用 GroupDocs.Signature for .NET 為 PDF 文件簽署元資料。此功能不僅可以增強文件安全性，還能改善資料管理和可追溯性。為了進一步探索，您可以考慮將此功能整合到更大的工作流程中，或嘗試使用該程式庫支援的不同類型的簽章。

常見問題部分

什麼是元資料簽章？
- 元資料簽名在簽署的文檔中嵌入附加資訊以供驗證。
我可以一次簽署多份文件嗎？
- 是的，您可以循環遍歷多個文件並將簽名過程應用於每個文件。
如何處理簽章中的不同資料型別？
- GroupDocs.Signature 支援各種資料類型，包括字串、日期、整數等，可以如上所示新增。
元資料條目的數量有限制嗎？
- 沒有明確的限制，但在添加大量元資料欄位時要考慮效能影響。
我可以自訂簽名的外觀嗎？
- 是的，GroupDocs.Signature 提供自訂簽名外觀的選項，包括字體和顏色。

資源

現在，利用您所學到的知識開始在您的專案中實作 GroupDocs.Signature for .NET！