介紹

條碼簽章廣泛用於數位文件工作流程，用於對結構化資料進行編碼，從而實現高效的追蹤、識別和驗證。 GroupDocs.Signature for .NET 是一款全面的文件簽章解決方案，可協助開發人員將進階簽章功能整合到其應用程式中，包括更新文件中現有條碼簽章的功能。

本教學重點在於如何使用 GroupDocs.Signature for .NET 更新文件中的條碼簽章。無論您需要修改現有條碼的位置、大小或編碼數據，本指南都將透過清晰的程式碼範例和說明引導您完成整個過程。

先決條件

在使用 GroupDocs.Signature for .NET 實作條碼簽章更新之前，請確保您已符合以下先決條件：

開發環境：可用的 .NET 開發環境，例如 Visual Studio 2017 或更高版本。
GroupDocs.Signature 函式庫：GroupDocs.Signature for .NET 函式庫，您可以從下載頁面.
基本 C# 知識：熟悉 C# 程式設計概念。
範例文件：包含您希望更新的條碼簽署的文件。

導入命名空間

首先匯入必要的命名空間來存取 GroupDocs.Signature 功能：

using System;
using System.Collections.Generic;
using System.IO;
using GroupDocs.Signature;
using GroupDocs.Signature.Domain;
using GroupDocs.Signature.Options;

現在，讓我們將更新條碼簽署的過程分解為可管理的步驟：

步驟 1：設定文檔路徑

首先，定義來源文件的路徑以及更新文件的儲存位置：

// 帶有條碼簽名的來源文件路徑
string filePath = "sample_multiple_signatures.docx";

// 取得輸出的檔名
string fileName = Path.GetFileName(filePath);

// 定義輸出目錄和檔案路徑
string outputDirectory = Path.Combine("Your Document Directory", "UpdateBarcode");
string outputFilePath = Path.Combine(outputDirectory, fileName);

// 確保輸出目錄存在
Directory.CreateDirectory(outputDirectory);

第 2 步：複製來源文檔

由於更新操作直接修改文檔，因此建立原始文檔的副本以保存它：

// 建立原始文件的副本
File.Copy(filePath, outputFilePath, true);

步驟3：初始化簽名實例

建立一個實例 Signature 與文件一起工作的類別：

// 使用輸出檔案路徑初始化簽章實例
using (Signature signature = new Signature(outputFilePath))
{
    // 簽名操作將在這裡執行
}

步驟 4：設定條碼搜尋選項

設定搜尋選項以尋找文件中現有的條碼簽名：

// 配置條碼簽名的搜尋選項
BarcodeSearchOptions options = new BarcodeSearchOptions()
{
    // 您可以按文字內容進行過濾
    Text = "12345",
    MatchType = TextMatchType.Contains
    
    // 取消註釋以在所有頁面上搜尋
    // 所有頁面 = true
};

步驟 5：搜尋條碼簽名

使用配置的搜尋選項在文件中尋找條碼簽名：

// 搜尋條碼簽名
List<BarcodeSignature> signatures = signature.Search<BarcodeSignature>(options);

步驟 6：更新條碼簽章屬性

如果找到條碼簽名，則根據需要更新其屬性：

// 檢查是否找到簽名
if (signatures.Count > 0)
{
    // 取得第一個條碼簽名
    BarcodeSignature barcodeSignature = signatures[0];
    
    // 更新位置
    barcodeSignature.Left = 100;
    barcodeSignature.Top = 100;
    
    // 更新大小
    barcodeSignature.Width = 400;
    barcodeSignature.Height = 100;
    
    // 應用程式更新
    bool result = signature.Update(barcodeSignature);
    
    // 檢查結果
    if (result)
    {
        Console.WriteLine($"Signature with Barcode '{barcodeSignature.Text}' and encode type '{barcodeSignature.EncodeType.TypeName}' was updated in the document ['{fileName}'].");
    }
    else
    {
        Console.WriteLine($"Signature was not updated in the document! Signature with Barcode '{barcodeSignature.Text}' and encode type '{barcodeSignature.EncodeType.TypeName}' was not found!");
    }
}
else
{
    Console.WriteLine("No barcode signatures found in the document.");
}

完整範例

這是一個完整的、實用的範例，示範如何更新文件中的條碼簽名：

using System;
using System.Collections.Generic;
using System.IO;
using GroupDocs.Signature;
using GroupDocs.Signature.Domain;
using GroupDocs.Signature.Options;

namespace UpdateBarcodeSignatureExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // 文件路徑
            string filePath = "sample_multiple_signatures.docx";
            
            // 定義輸出路徑
            string fileName = Path.GetFileName(filePath);
            string outputDirectory = Path.Combine(Environment.CurrentDirectory, "UpdateBarcode");
            string outputFilePath = Path.Combine(outputDirectory, fileName);
            
            // 確保輸出目錄存在
            Directory.CreateDirectory(outputDirectory);
            
            // 建立原始文件的副本
            File.Copy(filePath, outputFilePath, true);
            
            // 初始化簽名實例
            using (Signature signature = new Signature(outputFilePath))
            {
                // 配置搜尋選項
                BarcodeSearchOptions options = new BarcodeSearchOptions
                {
                    Text = "12345",
                    MatchType = TextMatchType.Contains
                };
                
                // 搜尋條碼簽名
                List<BarcodeSignature> signatures = signature.Search<BarcodeSignature>(options);
                
                // 檢查是否找到簽名
                if (signatures.Count > 0)
                {
                    // 取得第一個簽名
                    BarcodeSignature barcodeSignature = signatures[0];
                    
                    // 更新位置和大小
                    barcodeSignature.Left = 100;
                    barcodeSignature.Top = 100;
                    barcodeSignature.Width = 400;
                    barcodeSignature.Height = 100;
                    
                    // 應用程式更新
                    bool result = signature.Update(barcodeSignature);
                    
                    // 檢查結果
                    if (result)
                    {
                        Console.WriteLine($"Barcode signature was successfully updated in document '{fileName}'.");
                        Console.WriteLine($"Barcode text: {barcodeSignature.Text}");
                        Console.WriteLine($"Encode type: {barcodeSignature.EncodeType.TypeName}");
                        Console.WriteLine($"New position: {barcodeSignature.Left}x{barcodeSignature.Top}");
                        Console.WriteLine($"New size: {barcodeSignature.Width}x{barcodeSignature.Height}");
                        Console.WriteLine($"Output file path: {outputFilePath}");
                    }
                    else
                    {
                        Console.WriteLine("Failed to update barcode signature!");
                    }
                }
                else
                {
                    Console.WriteLine("No barcode signatures found in the document.");
                }
            }
            
            Console.WriteLine("\nPress any key to exit...");
            Console.ReadKey();
        }
    }
}

高級條碼簽名定制

GroupDocs.Signature 提供了基本位置和大小之外的自訂條碼簽章的附加選項：

調整外觀屬性

自訂條碼的視覺效果：

// 設定前景色（條碼顏色）
barcodeSignature.ForeColor = System.Drawing.Color.Blue;

// 設定背景顏色
barcodeSignature.BackgroundColor = System.Drawing.Color.LightYellow;

// 調整透明度
barcodeSignature.Opacity = 0.8;

新增邊框

使用自訂邊框增強條碼：

barcodeSignature.Border.Color = System.Drawing.Color.Red;
barcodeSignature.Border.DashStyle = System.Drawing.Drawing2D.DashStyle.Dash;
barcodeSignature.Border.Weight = 2;
barcodeSignature.Border.Visible = true;

旋轉條碼

將條碼簽名旋轉到特定角度：

barcodeSignature.Angle = 30; // 旋轉 30 度

結論

GroupDocs.Signature for .NET 提供了一個強大且靈活的解決方案，用於更新文件中的條碼簽章。按照本教學中概述的步驟，開發人員可以在其 .NET 應用程式中有效地實現條碼簽署更新功能，從而增強文件管理和自動化功能。

GroupDocs.Signature 憑藉其全面的功能集和直覺的 API，使開發人員能夠建立複雜的文件簽章解決方案，滿足現代商業應用程式的要求，同時確保文件的完整性和可存取性。

常見問題解答

我可以在單一文件中更新多個條碼簽名嗎？

是的，GroupDocs.Signature 允許您更新同一文件中的多個條碼簽署。搜尋簽名後，您可以遍歷結果清單並分別更新每個條碼簽名。

GroupDocs.Signature 是否支援不同的條碼格式？

是的，GroupDocs.Signature 支援多種條碼格式，包括線性條碼（Code 128、Code 39、EAN、UPC 等）和二維條碼（QR Code、Data Matrix、PDF417 等）。

GroupDocs.Signature for .NET 有試用版嗎？

是的，您可以從 GroupDocs 網站在購買之前評估圖書館的功能。

更新時我可以將一種條碼類型轉換為另一種嗎？

更新期間不支援直接轉換條碼類型。不過，您可以透過刪除現有條碼並新增所需格式的新條碼來實現。

更新條碼是否會影響其掃描功能？

更新條碼屬性（例如大小和位置）時，GroupDocs.Signature 會維護條碼的掃描完整性。但是，極小的尺寸或較大的旋轉角度可能會影響某些讀取器的掃描效能。

在哪裡可以找到對 GroupDocs.Signature for .NET 的額外支援？

您可以透過以下資源獲得全面的支援：