如何使用 GroupDocs.Signature for .NET 擷取文件資訊

介紹

在處理合約或任何已簽署的文件時，管理和驗證文件完整性至關重要。本教程將指導您使用 適用於 .NET 的 GroupDocs.Signature透過利用這個函式庫，開發人員可以自動化管理其應用程式中的數位簽章的過程。

在本指南中，您將了解：

如何為 .NET 設定 GroupDocs.Signature
檢索基本文件屬性，例如格式、大小和頁數
統計文件中的各種簽名類型
提取每個頁面的詳細信息

在深入實施之前，讓我們先了解先決條件。

先決條件

所需的函式庫、版本和相依性

要遵循本教程，您需要：

.NET Core 3.1 或稍後安裝在您的機器上。
這 適用於 .NET 的 GroupDocs.Signature 圖書館.

環境設定要求

確保您的開發環境配置了必要的工具，例如 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”並直接透過您的 IDE 安裝最新版本。

許可證取得步驟

免費試用：首先從下載免費試用版群組文檔。這樣您無需任何初始投資即可探索該庫的功能。
臨時執照：如果您需要更多時間進行評估，請考慮透過以下方式申請臨時許可證此連結.
購買：對於商業用途，請從購買許可證 GroupDocs 購買頁面.

基本初始化和設定

安裝完成後，初始化 Signature 物件與文檔的路徑。這對於存取 GroupDocs.Signature 的各種功能至關重要。

實施指南

本節將引導您使用 GroupDocs.Signature for .NET 擷取文件的基本資訊。

檢索文件資訊

概述

若要了解已簽署文件的結構和內容，請提取其元數據，例如文件類型、大小和頁數。對於需要根據這些屬性驗證或索引文件的應用程式來說，此過程至關重要。

using System;
using GroupDocs.Signature;
using GroupDocs.Signature.Domain;

string filePath = "YOUR_DOCUMENT_DIRECTORY\SampleSignedMulti";

// 使用文檔路徑初始化簽名對象
to (Signature signature = new Signature(filePath))
{
    // 使用 GetDocumentInfo 方法檢索文件資訊
    IDocumentInfo documentInfo = signature.GetDocumentInfo();
    
    // 輸出文檔的基本屬性
    Console.WriteLine($"- format : {documentInfo.FileType.FileFormat}");
    Console.WriteLine($"- extension : {documentInfo.FileType.Extension}");
    Console.WriteLine($"- size : {documentInfo.Size}");
    Console.WriteLine($"- page count : {documentInfo.PageCount}");

    // 各種簽名類型的輸出計數
    Console.WriteLine($"- Form Fields count : {documentInfo.FormFields.Count}");
    Console.WriteLine($"- Text signatures count : {documentInfo.TextSignatures.Count}");
    Console.WriteLine($"- Image signatures count : {documentInfo.ImageSignatures.Count}");
    Console.WriteLine($"- Digital signatures count : {documentInfo.DigitalSignatures.Count}");
    Console.WriteLine($"- Barcode signatures count : {documentInfo.BarcodeSignatures.Count}");
    Console.WriteLine($"- QrCode signatures count : {documentInfo.QrCodeSignatures.Count}");
    Console.WriteLine($"- FormField signatures count : {documentInfo.FormFieldSignatures.Count}");

    // 輸出頁面詳細信息，例如每頁的寬度和高度
    foreach (PageInfo pageInfo in documentInfo.Pages)
    {
        Console.WriteLine($"- page-{pageInfo.PageNumber} Width {pageInfo.Width}, Height {pageInfo.Height}");
    }
}

解釋

簽名物件初始化：先創建一個 Signature 包含文檔路徑的類別。此物件可作為存取各種文件相關功能的網關。
GetDocumentInfo 方法：透過呼叫此方法，您可以獲得有關文件的豐富元數據，其中不僅包括基本屬性，還包括有關其中存在的任何簽名的詳細資訊。
輸出文檔屬性：檢索到 IDocumentInfo 物件提供對檔案格式、副檔名、大小和頁數等諸多詳細資訊的存取。這對於根據文件特徵進行記錄或處理非常有用。
簽名櫃檯：了解文件中不同簽名類型的數量對於驗證過程至關重要。每種簽名類型（文字、圖像、數字等）都有特定的用途，了解它們的數量有助於驗證文件的完整性。
頁面資訊：存取每個頁面的尺寸允許應用程式調整佈局或執行依賴於頁面大小的操作。

故障排除提示

確保文件路徑指定正確；否則可能會引發異常。
驗證您的環境中是否設定了讀取檔案所需的所有權限。
如果遇到簽章計數問題，請確認簽章已正確嵌入正在使用的文件格式。

實際應用

文件管理系統：根據元資料自動組織和檢索文件。
合法軟體：在處理之前透過檢查所有必要的數位簽章來驗證合約。
歸檔解決方案：使用頁面大小資訊來優化儲存格式或佈局。
內容驗證工具：實施確保文件中存在所有必需簽名類型的系統。
與 CRM 系統集成：透過經過驗證和索引的簽名文件增強客戶記錄。

性能考慮

為了在使用 GroupDocs.Signature 時保持最佳效能，請考慮以下最佳做法：

非同步處理：盡可能非同步處理 I/O 操作，以防止阻塞主執行緒。
資源管理：處理 Signature 物件使用後應進行適當的清理，以釋放資源。
批次處理：處理多個文件時，請分批處理而不是逐一處理，以減少開銷。

結論

在本教學中，您學習如何使用 GroupDocs.Signature for .NET 擷取基本文件資訊。此功能對於需要深入了解已簽署文件的應用程式非常有用，有助於優化管理和驗證流程。為了進一步探索 GroupDocs.Signature 的功能，您可以嘗試其他功能，例如新增或驗證簽章。

準備好在您的專案中實施此解決方案了嗎？立即試用，增強您的文件處理工作流程！

常見問題部分

1. GroupDocs.Signature for .NET 用於什麼？ GroupDocs.Signature for .NET 是一個綜合性的函式庫，可促進數位簽章管理，提供從簽章文件中新增、驗證和擷取資訊等功能。