使用 GroupDocs.Signature for .NET 實作和顯示文件簽名

介紹

在進行任何流程之前，確保關鍵文件的真實性和完整性至關重要。 適用於 .NET 的 GroupDocs.Signature 提供強大的功能來提取文件中的詳細簽名信息，包括其詳細資訊和流程日誌。

在本綜合指南中，您將了解：

  • 如何使用 GroupDocs.Signature 設定您的環境
  • 實現檢索和顯示簽名資訊的功能
  • 理解並有效管理文件認證

讓我們先深入了解設定必要的先決條件。

先決條件

在實施之前，請確保滿足以下要求：

  • 庫和版本：安裝 .NET Core 或 .NET Framework。確保專案中的 GroupDocs.Signature for .NET 相容。
  • 環境設定：設定 Visual Studio 或支援 .NET 專案的類似 IDE。
  • 知識前提：建議對 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 = "YOUR_DOCUMENT_DIRECTORY/SAMPLE_SIGNED_MULTI";
SignatureSettings signatureSettings = new SignatureSettings()
{
    ShowDeletedSignaturesInfo = false
};

為什麼： 這可確保僅檢索現有簽章。

初始化簽名對象

使用 using 有效處理資源管理的語句：

using (Signature signature = new Signature(filePath, signatureSettings))
{
    // 進一步的操作請點擊此處
}
檢索文件資訊

取得與簽名和流程日誌相關的所有詳細資訊：

IDocumentInfo documentInfo = signature.GetDocumentInfo();

為什麼： 此方法收集有關文件簽名的全面資料。

顯示簽名詳細信息

迭代遍歷簽名集合：

Console.WriteLine($"Document actual Signatures : {documentInfo.Signatures.Count}");
foreach (BaseSignature baseSignature in documentInfo.Signatures)
{
    Console.WriteLine(
        $" - #{baseSignature.SignatureId}: Type: {baseSignature.SignatureType} Location: {baseSignature.Left}x{baseSignature.Top}. " +
        $"Size: {baseSignature.Width}x{baseSignature.Height}. CreatedOn/ModifiedOn: {baseSignature.CreatedOn.ToShortDateString()} / {baseSignature.ModifiedOn.ToShortDateString()}");
}

為什麼： 它清楚地說明了每個簽名的位置、大小和時間戳記。

顯示進程日誌詳細資訊

存取流程日誌以了解文件修改：

Console.WriteLine($"Document Process logs information: count = {documentInfo.ProcessLogs.Count}");
foreach (ProcessLog processLog in documentInfo.ProcessLogs)
{
    Console.WriteLine(
        $" - operation [{processLog.Type}] on {processLog.Date.ToShortDateString()}. Succeeded/Failed {processLog.Succeeded}/{processLog.Failed}. Message: {processLog.Message} : ");
    if (processLog.Signatures != null)
    {
        foreach (BaseSignature logSignature in processLog.Signatures)
        {
            Console.WriteLine($"\t\t -{logSignature.SignatureType} #{logSignature.SignatureId} at {logSignature.Top} x {logSignature.Left} pos;");
        }
    }
}

為什麼： 這些日誌為對文件執行的操作提供了審計跟踪，對於合規性和驗證至關重要。

故障排除提示

  • 文檔路徑問題：確保您的檔案路徑正確且可存取。
  • 權限：驗證您的應用程式是否有權限讀取指定的文件。
  • 庫更新：保持 GroupDocs.Signature 更新以避免與較新的 .NET 版本出現相容性問題。

實際應用

GroupDocs.Signature for .NET 可應用於各種實際場景：

  1. 合約管理系統：自動驗證並顯示合約簽名。
  2. 法律文件驗證：在採取法律行動之前，確保法律文件已由授權方簽署。
  3. 審計線索：維護文件變更的全面日誌以符合法規要求。

性能考慮

在處理大規模文件時，優化效能至關重要：

  • 非同步操作：盡可能利用非同步方法來提高應用程式的回應能力。
  • 資源管理：確保使用適當的資源處置 using 語句以防止記憶體洩漏。
  • 批次處理：對於批次操作，分批處理文件以最大限度地減少資源消耗。

結論

現在，您已經掌握如何使用 GroupDocs.Signature for .NET 實作和顯示文件簽章。這款強大的工具簡化了數位文件的驗證和審核流程，從而提高了安全性和效率。

若要進一步探索 GroupDocs.Signature 的功能，請考慮深入研究其 API 參考 或嘗試更進階的功能。

常見問題部分

  1. 我可以在 Web 應用程式中使用 GroupDocs.Signature for .NET 嗎？
    • 是的，它與 ASP.NET 和其他基於 .NET 的 Web 應用程式相容。
  2. GroupDocs.Signature 支援哪些類型的文件？
    • 它支援 PDF、Word 文件、Excel 文件、圖像等。
  3. 如何處理文件中的多個簽名？
    • 迭代 Signatures 收集以單獨處理每個簽名。
  4. 處理的簽名數量有限制嗎？
    • 沒有具體的限制；但是，效能可能會根據系統資源和文件大小而有所不同。
  5. 我可以自訂顯示的簽名詳細資訊的外觀嗎？
    • 是的，您可以透過調整應用程式中的程式碼來修改簽名資訊的呈現方式。

資源

如需更深入的知識與支援：

歡迎隨時在 [GroupDocs 論壇] 上尋求支持