掌握文档管理：使用 GroupDocs.Signature 实现 .NET 条形码签名集成

在当今的数字时代，确保文档的真实性和完整性对各行各业都至关重要。本指南演示了如何使用条形码签名集成到您的文档工作流程中 适用于 .NET 的 GroupDocs.Signature。无论您需要在文档中签署、验证、搜索、更新或删除条形码签名，本教程都会涵盖所有必要的方面。

您将学到什么

为 .NET 设置 GroupDocs.Signature
使用条形码签名对文档进行签名的步骤
验证、搜索、更新和删除条形码签名的技术
探索现实世界的应用和集成可能性
优化性能并有效管理资源

准备好增强您的文档管理系统了吗？让我们开始吧！

先决条件

在开始之前，请确保您具备以下条件：

.NET Core 3.1 或稍后安装在您的机器上。
具备 C# 编程基础知识并熟悉 .NET 环境设置。

所需的库和依赖项

要开始使用 GroupDocs.Signature for .NET，请通过包管理器安装库：

.NET CLI

dotnet add package GroupDocs.Signature

包管理器

Install-Package GroupDocs.Signature

NuGet 包管理器 UI

搜索“GroupDocs.Signature”并安装最新版本。

许可证获取

获取免费试用版、临时许可证，或购买完整许可证群组文档。如果您希望在购买前进行测试，请按照他们的指示获取临时许可证。

为 .NET 设置 GroupDocs.Signature

安装库后，请使用有效的许可证初始化并配置您的应用程序。设置方法如下：

安装 GroupDocs.Signature：使用上面提到的包管理器命令之一。
获取许可证：关注许可证获取步骤您选择的选项。

初始化 GroupDocs.Signature：

// 如果有许可证，请申请
License lic = new License();
lic.SetLicense("path/to/your/license/file.lic");

实施指南

探索使用 GroupDocs.Signature 实现 .NET 条形码签名集成的主要功能。

使用条形码签名签署文件

概述

此功能演示如何使用条形码签名签署文档，并在条形码中嵌入编码的特定文本以增强安全性。

实施步骤

准备您的环境：确保您已设置源目录和输出目录。

设置签名选项：

string filePath = "YOUR_DOCUMENT_DIRECTORY/YourDocument.docx";
string outputFilePath = Path.Combine("YOUR_OUTPUT_DIRECTORY", "SignedDocument.docx");
string bcText = "John Smith";

using (Signature signature = new Signature(filePath))
{
    BarcodeSignOptions signOptions = new BarcodeSignOptions(bcText, BarcodeTypes.Code128)
    {
        VerticalAlignment = VerticalAlignment.Top,
        HorizontalAlignment = HorizontalAlignment.Center,
        Width = 100,
        Height = 40,
        Margin = new Padding(20),
        ForeColor = Color.Red,
        Font = new SignatureFont { Size = 12, FamilyName = "Comic Sans MS" }
    };

    SignResult signResult = signature.Sign(outputFilePath, signOptions);
}

了解参数：
- bcText：您想要在条形码中编码的文本。
- BarcodeTypes.Code128：指定条形码类型。
- 外观选项，例如 VerticalAlignment， HorizontalAlignment， Width，和 Height 确定您的签名在文档上的外观。

验证文件条形码签名

概述

验证文档是否包含特定的条形码签名以确认其真实性。

实施步骤

设置验证选项：

string outputFilePath = "YOUR_OUTPUT_DIRECTORY/SignedDocument.docx";
string bcText = "John Smith";

using (Signature signature = new Signature(outputFilePath))
{
    BarcodeVerifyOptions verifyOptions = new BarcodeVerifyOptions()
    {
        AllPages = false,
        PageNumber = 1,
        EncodeType = BarcodeTypes.Code128,
        Text = bcText
    };

    VerificationResult verifyResult = signature.Verify(verifyOptions);
}

解释：
- AllPages：检查条形码是否存在于所有页面上，还是仅存在于特定页面上。
- PageNumber：指定要检查哪个页面进行验证。

搜索文档中的条形码签名

概述

搜索文档以查找任何现有的条形码签名，这对于审计和完整性检查很有用。

实施步骤

设置搜索选项：

string outputFilePath = "YOUR_OUTPUT_DIRECTORY/SignedDocument.docx";

using (Signature signature = new Signature(outputFilePath))
{
    BarcodeSearchOptions searchOptions = new BarcodeSearchOptions()
    {
        AllPages = true
    };

    List<BarcodeSignature> signatures = signature.Search<BarcodeSignature>(searchOptions);
}

关键点：
- AllPages：如果您希望搜索覆盖所有页面，请设置为 true。

更新文档条形码签名

概述

修改文档中现有的条形码签名，根据需要调整其位置或大小。

实施步骤

查找并修改签名：

string outputFilePath = "YOUR_OUTPUT_DIRECTORY/SignedDocument.docx";
List<BarcodeSignature> signatures = new List<BarcodeSignature>(); // 假设填充了条形码签名

foreach (BarcodeSignature bcSignature in signatures)
{
    bcSignature.Left += 100;
    bcSignature.Top += 100;
    bcSignature.Width = 200;
    bcSignature.Height = 50;
}

List<BaseSignature> signaturesToUpdate = signatures.ConvertAll(p => (BaseSignature)p);

using (Signature signature = new Signature(outputFilePath))
{
    UpdateResult updateResult = signature.Update(signaturesToUpdate);
}

解释：
- 调整 Left， Top， Width，和 Height 重新定位或调整签名的大小。

通过 ID 删除文档条形码签名

概述

使用其唯一 ID 从文档中删除特定的条形码签名，这对于清理过时或不正确的条目很有用。

实施步骤

设置删除选项：

string outputFilePath = "YOUR_OUTPUT_DIRECTORY/SignedDocument.docx";
List<string> signatureIds = new List<string>(); // 假设此列表包含要删除的签名的 ID

List<BaseSignature> signaturesToUpdate = new List<BaseSignature>();
foreach (var item in signatureIds)
{
    BarcodeSignature temp = new BarcodeSignature(item);
    signaturesToUpdate.Add(temp);
}

using (Signature signature = new Signature(outputFilePath))
{
    DeleteResult deleteResult = signature.Delete(signaturesToUpdate);
}

关键点：
- signatureIds：待删除的条形码签名ID列表。

实际应用

法律文件验证：通过签署具有唯一条形码的合同来确保真实性。
教育机构：验证学生证件，如身份证或成绩单。
商业合同：安全地签署和验证商业协议。
医疗记录：维护患者记录的完整性。
供应链管理：使用条形码签名跟踪和验证货物。

性能考虑

尽可能使用异步方法来优化性能，减少对文档处理要求较高的应用程序的加载时间。