如何實作 .NET GroupDocs.Signature 進行二維碼簽名

介紹

在數位時代，確保文件真實性對於法律和金融等行業至關重要。 適用於 .NET 的 GroupDocs.Signature 簡化電子簽名，提升安全與效率。本指南將教您如何在文件工作流程中實現二維碼簽名。

您將學到什麼：

使用 GroupDocs.Signature 透過二維碼簽署文檔
驗證、搜尋、更新和刪除文件中二維碼簽名的技術
使用此庫時的實際應用和效能考慮

在我們開始之前，讓我們先介紹一下必要的先決條件。

先決條件

為了繼續操作，請確保您已：

.NET 環境：設定 .NET Core 或 .NET Framework（版本 4.7.2 或更高版本）
GroupDocs.Signature 庫：透過以下方法之一安裝：
- .NET CLI： dotnet add package GroupDocs.Signature
- 套件管理器： Install-Package GroupDocs.Signature
- NuGet 套件管理器 UI：搜尋“GroupDocs.Signature”並安裝最新版本。
知識要求：對 C# 程式設計有基本的了解，並熟悉 .NET 開發環境

為 .NET 設定 GroupDocs.Signature

若要開始使用 GroupDocs.Signature，請設定您的環境：

安裝 GroupDocs.Signature：透過命令列或透過 Visual Studio 的 NuGet 套件管理器新增它，如上圖所示。
許可證獲取：
- 取得免費試用許可證以進行初步測試。
- 考慮申請臨時許可證以延長開發時間。
- 從 GroupDocs 網站購買完整許可證以供商業使用。
基本初始化和設定：安裝後，在您的 .NET 專案中初始化它以立即開始處理文件簽名。

實施指南

使用二維碼簽名簽署文件

概述

嵌入二維碼簽名可確保電子文件的可見性和安全性。

逐步實施：

1. 定義檔案路徑和文字

string filePath = "YOUR_DOCUMENT_DIRECTORY/sample.docx";
string outputFilePath = Path.Combine("YOUR_OUTPUT_DIRECTORY", "SignedSample.docx");
string bcText = "John Smith"; // 二維碼中要編碼的文本

2. 初始化簽名對象

using (Signature signature = new Signature(filePath))
{
    // 繼續定義並套用簽名選項
}

3. 設定二維碼簽名選項

QrCodeSignOptions signOptions = new QrCodeSignOptions(bcText, QrCodeTypes.QR)
{
    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" }
};

4. 應用程式簽名

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

這裡， signOptions 配置二維碼簽名的外觀和定位。

驗證文檔中的二維碼簽名

概述

驗證確保簽名後文件的完整性。

逐步實施：

1. 初始化驗證對象

using (Signature signature = new Signature(outputFilePath))
{
    // 繼續定義驗證選項
}

2. 配置驗證選項

QrCodeVerifyOptions verifyOptions = new QrCodeVerifyOptions()
{
    AllPages = false,
    PageNumber = 1,
    EncodeType = QrCodeTypes.QR,
    Text = bcText // 預期驗證的二維碼文本
};

3. 執行驗證

VerificationResult verifyResult = signature.Verify(verifyOptions);

此步驟檢查文件的二維碼是否匹配 bcText。

搜尋文檔中的二維碼簽名

概述

找到文件中現有的二維碼以有效地管理簽名。

逐步實施：

1.初始化搜尋對象

using (Signature signature = new Signature(outputFilePath))
{
    // 定義搜尋選項
}

2.配置搜尋選項

QrCodeSearchOptions searchOptions = new QrCodeSearchOptions()
{
    AllPages = true // 在所有頁面中搜尋
};

3.執行搜索

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

這將檢索文件中找到的二維碼簽章清單。

更新文檔二維碼簽名

概述

修改現有的二維碼以反映更新的資訊或外觀設定。

逐步實施：

1.初始化更新對象

using (Signature signature = new Signature(outputFilePath))
{
    // 假設「簽名」是從先前的搜尋操作中填入的
}

2. 更新每個二維碼簽名

foreach (QrCodeSignature qrSignature in signatures)
{
    qrSignature.Left += 100; // 例如：向右移動位置
    qrSignature.Top += 100;
    qrSignature.Width = 200;
    qrSignature.Height = 50;
}

3. 應用程式更新

List<BaseSignature> signaturesToUpdate = signatures.ConvertAll(p => (BaseSignature)p);
UpdateResult updateResult = signature.Update(signaturesToUpdate);

此部分更新找到的每個二維碼的位置和大小。

刪除文檔二維碼按ID簽名

概述

從您的文件中刪除不需要的或過時的二維碼。

逐步實施：

1.初始化刪除對象

using (Signature signature = new Signature(outputFilePath))
{
    // 假設 `signatureIds` 包含要刪除的簽章的 ID
}

2. 指定刪除簽名

List<QrCodeSignature> signaturesToDelete = signatureIds.ConvertAll(id => new QrCodeSignature(id));

3.刪除簽名

DeleteResult deleteResult = signature.Delete(signaturesToDelete);

這將從文件中刪除指定的二維碼簽章。

實際應用

法律合約：透過嵌入包含合約詳細資訊的二維碼來增強驗證流程。
財務文件：使用安全、可追蹤的二維碼簽章確保敏感財務報表的真實性。
教育證書：使用嵌入式二維碼簡化發行和驗證流程，方便取得學生資訊。

性能考慮

盡可能批量處理文檔，優化簽名處理。
在大規模操作期間監控記憶體使用情況，以防止資源耗盡。
對網路綁定任務使用非同步方法來提高應用程式的回應能力。

結論

合併 適用於 .NET 的 GroupDocs.Signature 將其融入您的文件管理流程，可增強安全性並簡化工作流程。遵循本指南，您現在即可使用各種工具有效地簽署、驗證、搜尋、更新和刪除文件中的二維碼簽名。接下來，您將探索 GroupDocs.Signature 的更多功能，並將其與其他系統集成，打造全面的文件解決方案。

常見問題部分

什麼是 GroupDocs.Signature？
- 一個促進應用程式內電子簽章整合的 .NET 函式庫。
二維碼如何用於簽名？
- 它們對姓名或合約細節等資料進行編碼，提供一種安全且可驗證的文件簽署方法。
我可以一次更新多個二維碼簽名嗎？
- 是的，使用事務操作來保證一致性。