使用 GroupDocs.Signature for .NET 在存檔文件中進行高效率的簽章搜尋

介紹

檔案通常包含敏感文檔，需要透過條碼和二維碼等簽名進行驗證。如果沒有合適的工具，在 ZIP、7Z 或 TAR 等壓縮檔案中搜尋這些簽名可能會非常困難。本教學將指導您如何使用 GroupDocs.Signature for .NET 簡化此流程。

您將學到什麼：

如何為 .NET 設定 GroupDocs.Signature
在存檔檔案中搜尋條碼和二維碼簽名
處理搜尋結果，包括成功和失敗的文件流程

在深入了解這項強大功能之前，讓我們先了解您需要的先決條件！

先決條件

為了有效地跟進：

所需的庫和依賴項：在您的開發環境中安裝適用於 .NET 的 GroupDocs.Signature。
環境設定要求：在您的系統上配置相容的.NET 環境（例如，.NET Core 3.1 或更高版本）。
知識前提：熟悉C#編程，對.NET專案設定有基本的了解。

為 .NET 設定 GroupDocs.Signature

安裝

使用下列方法之一安裝 GroupDocs.Signature for .NET：

.NET CLI

dotnet add package GroupDocs.Signature

套件管理器

Install-Package GroupDocs.Signature

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

許可證獲取

免費試用：從免費試用開始探索功能。
臨時執照：如果您需要在試用期之後延長存取權限，請取得此資訊。
購買：購買許可證以供長期使用。

安裝後，在您的專案中初始化 GroupDocs.Signature：

using GroupDocs.Signature;

實施指南

在檔案文件中搜尋簽名

此功能可讓您有效率地在存檔檔案中搜尋條碼和二維碼簽章。

概述

初始化一個 Signature 物件與已存檔文件的文件路徑一起使用搜尋選項來定位特定的簽章類型。

步驟1：初始化簽名對象

創建一個 Signature 例如，透過傳遞存檔文件的路徑：

string filePath = @"YOUR_DOCUMENT_DIRECTORY\SampleSignedZip.zip";
using (Signature signature = new Signature(filePath))
{
    // 進一步實施...
}

為什麼： 這 Signature 物件封裝了在文件中搜尋和管理簽名的所有功能。

第 2 步：配置搜尋選項

使用特定選項定義要搜尋的簽名類型：

BarcodeSearchOptions barcodeOptions = new BarcodeSearchOptions(BarcodeTypes.Code128);
QrCodeSearchOptions qrCodeOptions = new QrCodeSearchOptions(QrCodeTypes.QR);

List<SearchOptions> searchOptionsList = new List<SearchOptions>() { barcodeOptions, qrCodeOptions };

為什麼： 設定特定選項有助於將搜尋範圍縮小到相關的簽名類型，從而優化效能。

步驟3：執行搜尋

使用 Signature.Search 在檔案中尋找簽名的方法：

SearchResult result = signature.Search(searchOptionsList);

為什麼： 此方法處理文件並傳回所有找到的簽名的綜合結果。

步驟4：處理結果

遍歷結果以顯示或記錄成功的偵測，並處理遇到的任何錯誤：

int documentNumber = 1;
foreach (DocumentResultSignature document in result.Succeeded)
{
    Console.WriteLine($"Document #{documentNumber++}: {document.FileName}. Processed: {document.ProcessingTime}, mls");
    foreach (BaseSignature temp in document.Succeeded)
    {
        Console.WriteLine($"\t\t#{temp.SignatureId}: {temp.SignatureType}");
    }
}

if (result.Failed.Count > 0)
{
    documentNumber = 1;
    foreach (DocumentResultSignature document in result.Failed)
    {
        Console.WriteLine($"ERROR in Document #{documentNumber++}-{document.FileName}: {document.ErrorMessage}, mls");
    }
}

為什麼： 處理結果可以讓您了解哪些文件已成功分析並識別出遇到的問題。

故障排除提示

文件路徑錯誤：確保檔案路徑正確且可存取。
不支援的文件格式：驗證您的檔案格式是否受 GroupDocs.Signature 支援。
效能問題：優化大型檔案的搜尋選項以提高效能。

實際應用

文件驗證系統：自動對法律部門存檔文件中的簽名進行驗證。
資料完整性檢查：使用簽章搜尋來確保壓縮資料集中的資料完整性。
檔案軟體：整合到管理數位檔案的軟體中，為使用者提供簽名驗證功能。
合規審計：透過驗證歷史文檔庫中的簽名來協助合規性審計。
供應鏈管理：驗證存檔文件中儲存的已簽署的合約和協議。

性能考慮

為確保最佳性能：

將搜尋限制在必要的簽名類型內。
如果可能的話，單獨處理較小的檔案，以減少載入時間。
實作有效的錯誤處理以優雅地管理失敗的搜尋。遵循 .NET 記憶體管理最佳實踐，正確處理物件並最大限度地減少密集作業期間的資源使用。

結論

透過本教學課程，您學習如何使用 GroupDocs.Signature for .NET 在存檔文件中有效地搜尋簽章。這項強大的功能簡化了跨壓縮檔案的文件完整性管理。

後續步驟：

嘗試不同的簽名類型。
探索其他 GroupDocs.Signature 功能，例如簽署和驗證其他文件格式。

準備好進一步提升你的技能了嗎？嘗試在實際專案中實現此解決方案！

常見問題部分

如何安裝適用於 .NET 的 GroupDocs.Signature？
- 使用 .NET CLI、套件管理器或 NuGet UI 將其新增至您的專案。
我可以搜尋任何檔案格式的簽名嗎？
- 是的，GroupDocs.Signature 支援 ZIP、7Z 和 TAR 等格式。
如果我的文件在簽名搜尋過程中失敗怎麼辦？
- 檢查錯誤訊息以了解詳細資訊；確保檔案路徑正確且受 GroupDocs.Signature 支援。
如何有效率地處理大型檔案？
- 限制搜尋範圍並考慮單獨處理文件以提高效能。
使用 GroupDocs.Signature 是否需要任何費用？
- 從免費試用開始，取得臨時許可證以延長存取權限，或購買完整許可證以供長期使用。

資源

有了這份全面的指南，您現在就可以使用 GroupDocs.Signature for .NET 在存檔檔案中實作簽章搜尋了。祝您編碼愉快！