Perkenalan

Tanda tangan kode batang banyak digunakan dalam alur kerja dokumen digital untuk mengodekan data terstruktur, memungkinkan pelacakan, identifikasi, dan validasi yang efisien. GroupDocs.Signature untuk .NET adalah solusi penandatanganan dokumen komprehensif yang memungkinkan pengembang untuk mengintegrasikan fungsionalitas tanda tangan tingkat lanjut ke dalam aplikasi mereka, termasuk kemampuan untuk memperbarui tanda tangan kode batang yang ada di dalam dokumen.

Tutorial ini berfokus secara khusus pada pembaruan tanda tangan kode batang dalam dokumen menggunakan GroupDocs.Signature untuk .NET. Baik Anda perlu mengubah posisi, ukuran, atau data yang dikodekan dari kode batang yang sudah ada, panduan ini akan memandu Anda melalui prosesnya dengan contoh dan penjelasan kode yang jelas.

Prasyarat

Sebelum menerapkan pembaruan tanda tangan kode batang dengan GroupDocs.Signature untuk .NET, pastikan Anda memiliki prasyarat berikut:

Lingkungan Pengembangan: Lingkungan pengembangan .NET yang berfungsi seperti Visual Studio 2017 atau yang lebih baru.
Pustaka GroupDocs.Signature: Pustaka GroupDocs.Signature untuk .NET, yang dapat Anda unduh dari halaman unduhan.
Pengetahuan Dasar C#: Keakraban dengan konsep pemrograman C#.
Contoh Dokumen: Dokumen yang berisi tanda tangan kode batang yang ingin Anda perbarui.

Mengimpor Ruang Nama

Mulailah dengan mengimpor namespace yang diperlukan untuk mengakses fungsionalitas GroupDocs.Signature:

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

Sekarang, mari kita uraikan proses pembaruan tanda tangan kode batang ke dalam langkah-langkah yang dapat dikelola:

Langkah 1: Siapkan Jalur Dokumen

Pertama, tentukan jalur untuk dokumen sumber Anda dan tempat dokumen yang diperbarui akan disimpan:

// Jalur ke dokumen sumber dengan tanda tangan kode batang
string filePath = "sample_multiple_signatures.docx";

// Dapatkan nama file untuk keluaran
string fileName = Path.GetFileName(filePath);

// Tentukan direktori keluaran dan jalur file
string outputDirectory = Path.Combine("Your Document Directory", "UpdateBarcode");
string outputFilePath = Path.Combine(outputDirectory, fileName);

// Pastikan direktori keluaran ada
Directory.CreateDirectory(outputDirectory);

Langkah 2: Salin Dokumen Sumber

Karena operasi pembaruan memodifikasi dokumen secara langsung, buat salinan dokumen asli untuk menyimpannya:

// Buat salinan dokumen asli
File.Copy(filePath, outputFilePath, true);

Langkah 3: Inisialisasi Instansi Tanda Tangan

Buat contoh dari Signature kelas untuk bekerja dengan dokumen:

// Inisialisasi instance Tanda Tangan dengan jalur file keluaran
using (Signature signature = new Signature(outputFilePath))
{
    // Operasi tanda tangan akan dilakukan di sini
}

Langkah 4: Konfigurasikan Opsi Pencarian Kode Batang

Siapkan opsi pencarian untuk menemukan tanda tangan kode batang yang ada dalam dokumen:

// Konfigurasikan opsi pencarian untuk tanda tangan kode batang
BarcodeSearchOptions options = new BarcodeSearchOptions()
{
    // Anda dapat memfilter berdasarkan konten teks
    Text = "12345",
    MatchType = TextMatchType.Contains
    
    // Batalkan komentar untuk mencari di semua halaman
    // SemuaHalaman = benar
};

Langkah 5: Cari Tanda Tangan Barcode

Gunakan opsi pencarian yang dikonfigurasi untuk menemukan tanda tangan kode batang dalam dokumen:

// Cari tanda tangan kode batang
List<BarcodeSignature> signatures = signature.Search<BarcodeSignature>(options);

Langkah 6: Perbarui Properti Tanda Tangan Kode Batang

Jika tanda tangan kode batang ditemukan, perbarui propertinya sesuai kebutuhan:

// Periksa apakah tanda tangan ditemukan
if (signatures.Count > 0)
{
    // Dapatkan tanda tangan kode batang pertama
    BarcodeSignature barcodeSignature = signatures[0];
    
    // Perbarui posisi
    barcodeSignature.Left = 100;
    barcodeSignature.Top = 100;
    
    // Perbarui ukuran
    barcodeSignature.Width = 400;
    barcodeSignature.Height = 100;
    
    // Terapkan pembaruan
    bool result = signature.Update(barcodeSignature);
    
    // Periksa hasilnya
    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.");
}

Contoh Lengkap

Berikut adalah contoh lengkap dan fungsional yang menunjukkan cara memperbarui tanda tangan kode batang dalam dokumen:

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)
        {
            // Jalur dokumen
            string filePath = "sample_multiple_signatures.docx";
            
            // Tentukan jalur keluaran
            string fileName = Path.GetFileName(filePath);
            string outputDirectory = Path.Combine(Environment.CurrentDirectory, "UpdateBarcode");
            string outputFilePath = Path.Combine(outputDirectory, fileName);
            
            // Pastikan direktori keluaran ada
            Directory.CreateDirectory(outputDirectory);
            
            // Buat salinan dokumen asli
            File.Copy(filePath, outputFilePath, true);
            
            // Inisialisasi instance Tanda Tangan
            using (Signature signature = new Signature(outputFilePath))
            {
                // Konfigurasikan opsi pencarian
                BarcodeSearchOptions options = new BarcodeSearchOptions
                {
                    Text = "12345",
                    MatchType = TextMatchType.Contains
                };
                
                // Cari tanda tangan kode batang
                List<BarcodeSignature> signatures = signature.Search<BarcodeSignature>(options);
                
                // Periksa apakah tanda tangan ditemukan
                if (signatures.Count > 0)
                {
                    // Dapatkan tanda tangan pertama
                    BarcodeSignature barcodeSignature = signatures[0];
                    
                    // Perbarui posisi dan ukuran
                    barcodeSignature.Left = 100;
                    barcodeSignature.Top = 100;
                    barcodeSignature.Width = 400;
                    barcodeSignature.Height = 100;
                    
                    // Terapkan pembaruan
                    bool result = signature.Update(barcodeSignature);
                    
                    // Periksa hasil
                    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();
        }
    }
}

Kustomisasi Tanda Tangan Kode Batang Tingkat Lanjut

GroupDocs.Signature menyediakan opsi tambahan untuk menyesuaikan tanda tangan kode batang di luar posisi dan ukuran dasar:

Menyesuaikan Properti Penampilan

Sesuaikan aspek visual kode batang:

// Mengatur warna latar depan (warna kode batang)
barcodeSignature.ForeColor = System.Drawing.Color.Blue;

// Atur warna latar belakang
barcodeSignature.BackgroundColor = System.Drawing.Color.LightYellow;

// Sesuaikan transparansi
barcodeSignature.Opacity = 0.8;

Menambahkan Batas

Tingkatkan kode batang dengan batas khusus:

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

Memutar Kode Batang

Putar tanda tangan kode batang ke sudut tertentu:

barcodeSignature.Angle = 30; // Putar 30 derajat

Kesimpulan

GroupDocs.Signature untuk .NET menyediakan solusi yang andal dan fleksibel untuk memperbarui tanda tangan kode batang dalam dokumen. Dengan mengikuti langkah-langkah yang diuraikan dalam tutorial ini, pengembang dapat secara efisien mengimplementasikan fungsionalitas pembaruan tanda tangan kode batang dalam aplikasi .NET mereka, yang meningkatkan kemampuan manajemen dan otomatisasi dokumen.

Dengan rangkaian fitur yang komprehensif dan API yang intuitif, GroupDocs.Signature memungkinkan pengembang untuk membangun solusi penandatanganan dokumen canggih yang memenuhi persyaratan aplikasi bisnis modern sekaligus memastikan integritas dan aksesibilitas dokumen.

Pertanyaan yang Sering Diajukan

Bisakah saya memperbarui beberapa tanda tangan kode batang dalam satu dokumen?

Ya, GroupDocs.Signature memungkinkan Anda memperbarui beberapa tanda tangan kode batang dalam dokumen yang sama. Setelah mencari tanda tangan, Anda dapat menelusuri daftar yang dihasilkan dan memperbarui setiap tanda tangan kode batang satu per satu.

Apakah GroupDocs.Signature mendukung format kode batang yang berbeda?

Ya, GroupDocs.Signature mendukung berbagai macam format kode batang, termasuk kode batang linear (Kode 128, Kode 39, EAN, UPC, dll.) dan kode batang 2D (Kode QR, Matriks Data, PDF417, dll.).

Apakah ada versi uji coba yang tersedia untuk GroupDocs.Signature untuk .NET?

Ya, Anda dapat mengunduh versi uji coba gratis dari Situs web GroupDocs untuk mengevaluasi fitur perpustakaan sebelum melakukan pembelian.

Bisakah saya mengubah satu jenis kode batang ke jenis lainnya saat memperbarui?

Konversi langsung antar jenis kode batang tidak didukung selama pembaruan. Namun, Anda dapat melakukannya dengan menghapus kode batang yang ada dan menambahkan kode batang baru dengan format yang diinginkan.

Apakah memperbarui kode batang memengaruhi kemampuan pemindaiannya?

Saat memperbarui properti kode batang seperti ukuran dan posisi, GroupDocs.Signature mempertahankan integritas pemindaian kode batang. Namun, ukuran yang sangat kecil atau sudut rotasi yang besar dapat memengaruhi kinerja pemindaian pada beberapa pembaca.

Di mana saya dapat menemukan dukungan tambahan untuk GroupDocs.Signature untuk .NET?

Anda dapat menemukan dukungan komprehensif melalui sumber daya berikut: