如何使用 GroupDocs.Signature for .NET 取消文件驗證：事件處理指南

介紹

您是否正在尋找高效的方法來管理長時間運行的文件驗證任務？透過 GroupDocs.Signature for .NET，您可以處理進度事件，從而有效地監控和控制這些流程。本指南將向您展示如何實現一個根據特定條件（例如處理時間超過閾值）取消操作的系統。

在本文中，我們將探討：

  • 設定並安裝 GroupDocs.Signature for .NET
  • 在應用程式中實現進度事件處理
  • 根據特定條件取消進程
  • 這些功能的實際應用

先決條件

所需的庫和依賴項

若要遵循本指南，請確保您已：

  • 適用於 .NET 的 GroupDocs.Signature：文檔簽名的核心庫。
  • .NET Framework 或 .NET Core：建議使用4.6.1或更高版本。

環境設定要求

確保您的開發環境設定了 Visual Studio 或支援 .NET 專案的相容 IDE。

知識前提

熟悉 C# 和 .NET 中事件處理的基本知識將會有所幫助，但不是強制性的，因為我們將在這裡介紹基本知識。

為 .NET 設定 GroupDocs.Signature

首先，使用以下方法之一安裝 GroupDocs.Signature 庫：

.NET CLI

dotnet add package GroupDocs.Signature

套件管理器

Install-Package GroupDocs.Signature

NuGet 套件管理器 UI 搜尋“GroupDocs.Signature”並安裝最新版本。

許可證獲取

您可以取得免費試用許可證來測試 GroupDocs.Signature 的全部功能。如果您要用於生產環境，可以考慮購買許可證：

  • 免費試用：非常適合測試和初步開發。
  • 臨時執照：如果您需要試用期以外的更多時間進行評估，這將很有用。
  • 購買：獲得長期商業項目的完整許可。

基本初始化

安裝後，在專案中初始化 GroupDocs.Signature 以開始使用文件簽章：

using GroupDocs.Signature;

此設定允許您創建 Signature 並開始探索其功能。

實施指南

我們將把實施過程分解為可管理的部分，並專注於不同的功能。

功能 1：進度事件處理

處理進度事件的功能可讓您監控正在進行的進程。以下是實現此功能的方法：

概述

此功能可讓您的應用程式對進程進度的變化做出反應，提供在需要時取消操作的機制。

逐步實施

3.1 設定事件處理程序 首先，定義一個事件處理方法，檢查處理時間是否超過 100 毫秒（0.1 秒）。

private static void OnVerifyProgress(Signature sender, ProcessProgressEventArgs args)
{
    // 檢查處理時間是否超過 350 個刻度。
    if (args.Ticks > 350) 
    {
        args.Cancel = true; // 取消該進程。
        Console.WriteLine("Sign progress was canceled. Time spent {0} mlsec", args.Ticks);
    }
}

3.2 附加事件處理程序 接下來，將此事件處理程序附加到您的 Signature 您的驗證方法中的實例。

using (Signature signature = new Signature(filePath))
{
    // 附加進度事件的事件處理程序。
    signature.VerifyProgress += OnVerifyProgress;

    ...
}

3.3 執行驗證流程 最後，在處理潛在取消的同時執行文件驗證流程：

// 執行驗證過程。
VerificationResult result = signature.Verify(options);

if (result.IsValid)
{
    Console.WriteLine("Document verification was not canceled!");
}
else
{
    Console.WriteLine("Document verification was canceled successfully!");
}

功能2：文件驗證及取消

本節重點介紹如何驗證文檔，同時結合進度事件處理以進行取消。

概述

透過設定驗證選項並附加進度處理程序，您可以在過程耗時過長時取消該過程，從而確保您的應用程式保持回應。

4.1 定義驗證選項 設定 TextVerifyOptions 指定文檔的哪些方面需要驗證：

TextVerifyOptions options = new TextVerifyOptions("Text signature")
{
    // 可以在此處指定其他配置。
};

實際應用

了解進度事件的處理和取消功能如何為您的應用程式帶來益處至關重要。以下是一些用例：

  1. 批次處理：在需要驗證多個文件的情況下有效地管理處理時間。
  2. 使用者回饋系統：當操作時間超出預期時向使用者提供即時回饋，提升使用者體驗。
  3. 資源管理：自動取消可能對系統資源帶來壓力的長時間運作的任務。
  4. 與工作流程自動化集成：在更大的自動化工作流程中使用這些功能，以確保順利運作而不會延遲。
  5. 測試和開發環境：快速測試您的應用程式如何處理不同的處理場景。

性能考慮

使用 GroupDocs.Signature 時優化效能對於維持高效操作至關重要：

  • 資源使用情況：注意記憶體使用情況，尤其是在處理大型文件時。

  • 最佳實踐：

    • 處置 Signature 對象及時釋放資源。
    • 明智地使用取消事件以防止不必要的處理。

結論

在本教學中，您學習如何使用 GroupDocs.Signature for .NET 在文件驗證中實作進度事件處理和流程取消。這些技術可以顯著提高應用程式的效率和回應能力。

下一步，考慮探索 GroupDocs.Signature 提供的其他功能，例如數位簽章和簽章搜尋功能，以進一步改善您的文件管理解決方案。

常見問題部分

Q1：在 GroupDocs.Signature 中處理進度事件的目的為何？ 進度事件有助於監視和控制長時間運行的驗證任務，如果它們超過某個時間閾值，您可以取消它們。

Q2：如何附加進程進度事件處理程序？ 使用 VerifyProgress 您的活動 Signature 實例。

Q3：取消文檔處理有哪些常見場景？ 適用於批次、使用者回饋系統和資源管理，以維持系統效率。

Q4：我可以調整取消流程的時間閾值嗎？ 是的，修改事件處理程序方法中的條件（例如， args.Ticks > 350) 以滿足您的要求。

Q5：如果我的應用程式需要處理多種文件類型，我該怎麼辦？ GroupDocs.Signature 支援多種文件格式。請確保為每種類型配置適當的驗證選項。

資源