如何使用 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 是一个综合性的库，可促进数字签名管理，提供从签名文档中添加、验证和提取信息等功能。