使用 GroupDocs.Signature 掌握 .NET 中的簽章管理

介紹

在當今的數位時代，高效管理文件簽名對企業和個人都至關重要。無論您是要驗證合約還是確保合規性，合適的工具都能發揮重要作用。本教學將指導您如何使用 適用於 .NET 的 GroupDocs.Signature 無縫管理和刪除文件中的簽名。

您將學到什麼：

如何初始化簽名實例。
新增用於偵測簽名的各種搜尋選項。
在文件中搜尋不同類型的簽名。
有效率刪除多個簽章。

準備好了嗎？我們先來了解先決條件。

先決條件

在開始之前，請確保您具備以下條件：

所需庫GroupDocs.Signature for .NET
環境設定：安裝了 .NET Framework 或 .NET Core 的 Visual Studio 2019 或更高版本。
知識前提：對 C# 和 .NET 開發有基本的了解。

為 .NET 設定 GroupDocs.Signature

首先，您需要安裝 GroupDocs.Signature 庫。具體步驟如下：

安裝說明

使用 .NET CLI：

dotnet add package GroupDocs.Signature

套件管理器控制台：

Install-Package GroupDocs.Signature

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

許可證獲取

您可以先免費試用，探索各項功能。如需延長使用時間，請考慮取得臨時許可證或從以下網站購買許可證：群組文檔.

實施指南

讓我們逐步分解每個功能。

功能1：初始化簽名實例

此功能示範如何使用 GroupDocs.Signature for .NET 設定用於管理文件中簽署的環境。

概述

初始化 Signature 實例至關重要，因為它為文件準備搜尋和刪除等簽名操作。

程式碼實現

using System.IO;
using GroupDocs.Signature;

var filePath = Path.Combine("YOUR_DOCUMENT_DIRECTORY", "Sample_Signed_Multi_Document");
Directory.CreateDirectory(Path.GetDirectoryName(filePath)); // 確保該目錄存在。
File.Copy(filePath, outputFilePath, true);

// 使用文件路徑初始化簽章實例
using (Signature signature = new Signature(outputFilePath))
{
    // 簽章實例現已準備好進行操作。
}

解釋

filePath：來源文檔的路徑。
Directory.CreateDirectory(...)：嘗試檔案操作之前確保目錄存在。
signature：促進所有與簽名相關的任務的主要對象。

功能 2：新增搜尋選項

有效地偵測簽名需要指定您在文件中尋找什麼類型的簽名。

概述

新增搜尋選項可讓您定位文件中的特定類型的簽名，例如文字、條碼、二維碼或基於圖像的簽名。

程式碼實現

using System.Collections.Generic;
using GroupDocs.Signature.Options;

List<SearchOptions> listOptions = new List<SearchOptions>();
listOptions.Add(new TextSearchOptions()); // 搜尋基於文字的簽名。
listOptions.Add(new BarcodeSearchOptions()); // 搜尋條碼簽名。
listOptions.Add(new QrCodeSearchOptions()); // 搜尋二維碼簽名。
listOptions.Add(new ImageSearchOptions()); // 搜尋基於圖像的簽名。

// listOptions 現在包含在文件中查找不同類型簽章所需的所有搜尋選項。

解釋

TextSearchOptions：針對文檔內的文字簽名。
BarcodeSearchOptions， QrCodeSearchOptions，和 ImageSearchOptions：分別啟用條碼、二維碼和基於影像的簽名的偵測。

功能 3：搜尋文件中的簽名

設定搜尋選項後，您現在可以在文件中找到這些簽名。

概述

此功能重點介紹如何使用指定的簽名選項搜尋文件並相應地處理結果。

程式碼實現

using System.Collections.Generic;
using GroupDocs.Signature.Domain;

string filePath = Path.Combine("YOUR_DOCUMENT_DIRECTORY", "Sample_Signed_Multi_Document");
Directory.CreateDirectory(Path.GetDirectoryName(filePath)); // 確保目錄存在。
File.Copy(filePath, outputFilePath, true);

using (Signature signature = new Signature(outputFilePath))
{
    List<SearchOptions> listOptions = new List<SearchOptions>();
    listOptions.Add(new TextSearchOptions());
    listOptions.Add(new BarcodeSearchOptions());
    listOptions.Add(new QrCodeSearchOptions());
    listOptions.Add(new ImageSearchOptions());

    // 使用指定的選項搜尋簽名。
    SearchResult result = signature.Search(listOptions);

    if (result.Signatures.Count > 0)
    {
        // 在文件中找到簽名。
    }
    else
    {
        // 文件中未發現任何簽名。
    }
}

解釋

SearchResult：包含所有檢測到的簽名的詳細信息，允許進一步處理（如刪除）。

功能 4：從文件中刪除簽名

一旦確定了不需要的簽名，下一步就是有效地將其刪除。

概述

此功能示範如何使用 GroupDocs.Signature for .NET 從文件中刪除多種類型的簽章。

程式碼實現

using System.Collections.Generic;
using GroupDocs.Signature.Domain;

string filePath = Path.Combine("YOUR_DOCUMENT_DIRECTORY", "Sample_Signed_Multi_Document");
Directory.CreateDirectory(Path.GetDirectoryName(filePath)); // 確保目錄存在。
File.Copy(filePath, outputFilePath, true);

using (Signature signature = new Signature(outputFilePath))
{
    List<SearchOptions> listOptions = new List<SearchOptions>();
    listOptions.Add(new TextSearchOptions());
    listOptions.Add(new BarcodeSearchOptions());
    listOptions.Add(new QrCodeSearchOptions());
    listOptions.Add(new ImageSearchOptions());

    // 搜尋簽名。
    SearchResult result = signature.Search(listOptions);

    if (result.Signatures.Count > 0)
    {
        List<BaseSignature> signaturesToDelete = new List<BaseSignature>();

        // 收集簽名以刪除。
        foreach (BaseSignature temp in result.Signatures)
        {
            signaturesToDelete.Add(temp);
        }

        // 從文件中刪除收集的簽名。
        DeleteResult deleteResult = signature.Delete(signaturesToDelete);
    }
}

解釋

signaturesToDelete：已確定要刪除的簽章集合。
DeleteResult：提供刪除過程成功或失敗的回饋。

實際應用

合約管理：自動驗證並刪除合約中的過時簽名。
合規審計：透過審核和清理簽名確保所有文件符合監管要求。
文件生命週期管理：管理文件簽章的整個生命週期，從建立到存檔。

性能考慮

在搜尋或刪除簽名時僅處理文件的必要部分，從而優化效能。
監控資源使用情況，以確保您的應用程式在簽署作業期間保持高效且反應迅速。