如何使用 GroupDocs.Signature for .NET 对包含元数据的 Excel 电子表格进行签名

介绍

确保 Excel 电子表格的真实性和完整性至关重要，尤其是在处理敏感数据时。 适用于 .NET 的 GroupDocs.Signature 提供无缝解决方案，允许您添加元数据签名，而无需更改文档的原始结构。此功能对于管理关键信息的企业或自动化文档工作流程的开发人员来说非常宝贵。

在本教程中，我们将指导您使用 GroupDocs.Signature for .NET 的元数据签名对 Excel 文档进行签名。读完本文后，您将能够：

  • 设置并初始化 GroupDocs.Signature 库
  • 配置元数据签名并将其应用到您的电子表格
  • 处理大型数据集时优化性能

在开始之前，我们先回顾一下先决条件。

先决条件

确保已做好以下准备：

所需的库和版本

  • 适用于 .NET 的 GroupDocs.Signature：通过 NuGet 或其他包管理器安装。

环境设置要求

  • .NET 开发环境（例如 Visual Studio）
  • 熟悉 C# 编程
  • 了解 Excel 文档结构和元数据

为 .NET 设置 GroupDocs.Signature

要开始使用元数据签署电子表格，请设置 GroupDocs.签名 .NET 项目中的库。

安装

通过不同的包管理器安装 GroupDocs.Signature：

.NET CLI

dotnet add package GroupDocs.Signature

程序包管理器控制台

Install-Package GroupDocs.Signature

NuGet 包管理器 UI

  • 在 Visual Studio 中打开 NuGet 包管理器。
  • 搜索“GroupDocs.Signature”并安装最新版本。

许可证获取

在使用 GroupDocs.Signature 之前，请获取许可证：

  • 免费试用：通过下载试用版来探索基本功能 这里.
  • 临时执照：通过以下方式获得扩展测试能力 此链接.
  • 购买：如需完全访问权限，请通过 GroupDocs 购买页面.

基本初始化

在您的项目中初始化 GroupDocs.Signature 如下：

using GroupDocs.Signature;

// 使用输入文件路径初始化签名对象
Signature signature = new Signature("YOUR_DOCUMENT_DIRECTORY/Spreadsheet.xlsx");

实施指南

我们将把实施过程分解为逻辑步骤，以使用元数据签名对 Excel 电子表格进行签名。

步骤 1：定义元数据签名

创建将添加到文档的元数据条目列表。每个条目都应包含与您的需求相关的特定数据类型和值。

using GroupDocs.Signature.Domain;
using System;

// 创建元数据签名选项以指定元数据签名
MetadataSignOptions options = new MetadataSignOptions();

SpreadsheetMetadataSignature[] signatures = new SpreadsheetMetadataSignature[]
{
    new SpreadsheetMetadataSignature("Author", "Mr. Scherlock Holmes"), // 将作者添加为字符串值
    new SpreadsheetMetadataSignature("CreatedOn", DateTime.Now), // 添加带有当前时间戳的创建日期
    new SpreadsheetMetadataSignature("DocumentId", 123456), // 分配一个整数文档 ID
    new SpreadsheetMetadataSignature("SignatureId", 123.456D), // 分配双重签名 ID
    new SpreadsheetMetadataSignature("Amount", 123.456M), // 将金额设置为小数值
    new SpreadsheetMetadataSignature("Total", 123.456F) // 使用浮点值设置总计
};

options.Signatures.AddRange(signatures); // 将所有元数据签名添加到选项

第 2 步：签署并保存文档

配置元数据选项后，您现在可以签署文档并保存它。

using GroupDocs.Signature.Options;

string outputFilePath = Path.Combine("YOUR_OUTPUT_DIRECTORY", "SignSpreadsheetWithMetadata", "SignedWithMetadata.xlsx");

// 签署文档并保存到指定的输出路径
SignResult result = signature.Sign(outputFilePath, options);

参数和返回值

  • 签名（文件路径）：初始化一个新的实例 Signature 带有文件路径的类。
  • 元数据签名选项：表示元数据签名设置。
  • SpreadsheetMetadataSignature(名称，值)：定义单独的元数据条目。
  • 签名结果：包含有关签名过程信息的结果对象。

故障排除提示

如果您遇到问题：

  • 确保您的文档路径指定正确且可访问。
  • 验证所有必需的库是否已在项目中正确安装和引用。
  • 检查签名过程中引发的任何异常，以识别潜在的配置错误。

实际应用

以下是此功能有益的一些实际场景：

  1. 文件审计：自动添加元数据签名以跟踪文档随时间的变化。
  2. 数据验证：使用元数据条目来验证财务报告中的文档真实性。
  3. 工作流自动化：与 CRM 系统集成，有效管理客户协议和合同。

性能考虑

为确保使用 GroupDocs.Signature for .NET 时获得最佳性能：

  • 批量处理文档而不是单独处理文档以减少开销。
  • 监控内存使用情况并优化大型数据集的垃圾收集设置。
  • 尽可能实施异步签名流程，以提高应用程序的响应能力。

结论

本教程探讨了如何使用 GroupDocs.Signature for .NET 为 Excel 电子表格签名元数据。按照上述步骤操作，您可以增强文档安全性并简化工作流程。

要进一步探索 GroupDocs.Signature 的功能，请考虑深入研究其广泛的 文档 或尝试 API 参考中提供的其他功能。如果您已准备好运用这些知识，请从以下位置下载试用版 这里，今天就开始签署您的文件！

常见问题解答部分

问题 1：我可以使用 GroupDocs.Signature for .NET 签署 PDF 吗？ 是的！GroupDocs.Signature 支持各种文档格式，包括 PDF。

Q2：元数据和数字签名有什么区别？ 元数据签名将信息嵌入文档本身，而数字签名则使用加密方法来验证真实性。

问题 3：如何管理长期使用的许可证？ 如需长期使用，请考虑通过 GroupDocs 购买页面.

问题4：我可以签署的文件数量有限制吗？ 试用版可能有一定的限制；这些限制可以通过购买或临时许可证解除。

问题 5：如果我的元数据签名没有出现在文档中怎么办？ 确保您的配置设置符合文档格式要求，并检查签名过程中是否存在任何错误。

资源