掌握文件管理：使用 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清單。

實際應用

法律文件驗證：透過簽署具有唯一條碼的合約來確保真實性。
教育機構：驗證學生證件，如身分證或成績單。
商業合約：安全地簽署和驗證商業協議。
醫療記錄：維護病患記錄的完整性。
供應鏈管理：使用條碼簽名追蹤和驗證貨物。

性能考慮

盡可能使用非同步方法來最佳化效能，減少對文件處理要求較高的應用程式的載入時間。