giriiş

Barkod imzaları, yapılandırılmış verileri kodlamak ve verimli izleme, tanımlama ve doğrulama sağlamak için dijital belge iş akışlarında yaygın olarak kullanılır. GroupDocs.Signature for .NET, geliştiricilerin gelişmiş imza işlevlerini uygulamalarına entegre etmelerini sağlayan kapsamlı bir belge imzalama çözümüdür. Bu işlevler arasında, belgelerdeki mevcut barkod imzalarını güncelleme yeteneği de yer alır.

Bu eğitim, özellikle .NET için GroupDocs.Signature kullanarak belgelerdeki barkod imzalarını güncellemeye odaklanmaktadır. Mevcut barkodların konumunu, boyutunu veya kodlanmış verilerini değiştirmeniz gerekip gerekmediğini açıklayan bu kılavuz, anlaşılır kod örnekleri ve açıklamalarla süreci adım adım açıklayacaktır.

Ön koşullar

GroupDocs.Signature for .NET ile barkod imza güncellemelerini uygulamadan önce, aşağıdaki ön koşulların mevcut olduğundan emin olun:

  1. Geliştirme Ortamı: Visual Studio 2017 veya üzeri gibi çalışan bir .NET geliştirme ortamı.
  2. GroupDocs.Signature Kütüphanesi: .NET için GroupDocs.Signature kütüphanesini şu adresten indirebilirsiniz: indirme sayfası.
  3. Temel C# Bilgisi: C# programlama kavramlarına aşinalık.
  4. Örnek Belgeler: Güncellemek istediğiniz barkod imzalarını içeren belge(ler).

Ad Alanlarını İçe Aktar

GroupDocs.Signature işlevine erişmek için gerekli ad alanlarını içe aktararak başlayın:

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

Şimdi barkod imzalarının güncellenme sürecini yönetilebilir adımlara bölelim:

Adım 1: Belge Yollarını Ayarlayın

Öncelikle kaynak belgenizin yollarını ve güncellenen belgenin nereye kaydedileceğini tanımlayın:

// Barkod imzalı kaynak belgeye giden yol
string filePath = "sample_multiple_signatures.docx";

// Çıktı için dosya adını al
string fileName = Path.GetFileName(filePath);

// Çıktı dizinini ve dosya yolunu tanımlayın
string outputDirectory = Path.Combine("Your Document Directory", "UpdateBarcode");
string outputFilePath = Path.Combine(outputDirectory, fileName);

// Çıktı dizininin mevcut olduğundan emin olun
Directory.CreateDirectory(outputDirectory);

Adım 2: Kaynak Belgeyi Kopyalayın

Güncelleme işlemi belgeyi doğrudan değiştirdiğinden, orijinal belgeyi korumak için bir kopyasını oluşturun:

// Orijinal belgenin bir kopyasını oluşturun
File.Copy(filePath, outputFilePath, true);

Adım 3: İmza Örneğini Başlatın

Bir örneğini oluşturun Signature belgeyle çalışmak için sınıf:

// İmza örneğini çıktı dosyası yoluyla başlatın
using (Signature signature = new Signature(outputFilePath))
{
    // İmza işlemleri burada gerçekleştirilecektir
}

Adım 4: Barkod Arama Seçeneklerini Yapılandırın

Belgedeki mevcut barkod imzalarını bulmak için arama seçeneklerini ayarlayın:

// Barkod imzaları için arama seçeneklerini yapılandırın
BarcodeSearchOptions options = new BarcodeSearchOptions()
{
    // Metin içeriğine göre filtreleme yapabilirsiniz
    Text = "12345",
    MatchType = TextMatchType.Contains
    
    // Tüm sayfalarda arama yapmak için yorum işaretini kaldırın
    // TümSayfalar = true
};

Adım 5: Barkod İmzalarını Arayın

Belgedeki barkod imzalarını bulmak için yapılandırılmış arama seçeneklerini kullanın:

// Barkod imzalarını arayın
List<BarcodeSignature> signatures = signature.Search<BarcodeSignature>(options);

Adım 6: Barkod İmza Özelliklerini Güncelleyin

Barkod imzaları bulunursa, özelliklerini gerektiği gibi güncelleyin:

// İmzaların bulunup bulunmadığını kontrol edin
if (signatures.Count > 0)
{
    // İlk barkod imzasını alın
    BarcodeSignature barcodeSignature = signatures[0];
    
    // Pozisyonu güncelle
    barcodeSignature.Left = 100;
    barcodeSignature.Top = 100;
    
    // Güncelleme boyutu
    barcodeSignature.Width = 400;
    barcodeSignature.Height = 100;
    
    // Güncellemeleri uygula
    bool result = signature.Update(barcodeSignature);
    
    // Sonucu kontrol edin
    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.");
}

Tam Örnek

İşte bir belgedeki barkod imzasının nasıl güncelleneceğini gösteren eksiksiz, işlevsel bir örnek:

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)
        {
            // Belge yolu
            string filePath = "sample_multiple_signatures.docx";
            
            // Çıkış yolunu tanımla
            string fileName = Path.GetFileName(filePath);
            string outputDirectory = Path.Combine(Environment.CurrentDirectory, "UpdateBarcode");
            string outputFilePath = Path.Combine(outputDirectory, fileName);
            
            // Çıktı dizininin mevcut olduğundan emin olun
            Directory.CreateDirectory(outputDirectory);
            
            // Orijinal belgenin bir kopyasını oluşturun
            File.Copy(filePath, outputFilePath, true);
            
            // İmza örneğini başlat
            using (Signature signature = new Signature(outputFilePath))
            {
                // Arama seçeneklerini yapılandırın
                BarcodeSearchOptions options = new BarcodeSearchOptions
                {
                    Text = "12345",
                    MatchType = TextMatchType.Contains
                };
                
                // Barkod imzalarını arayın
                List<BarcodeSignature> signatures = signature.Search<BarcodeSignature>(options);
                
                // İmzaların bulunup bulunmadığını kontrol edin
                if (signatures.Count > 0)
                {
                    // İlk imzayı alın
                    BarcodeSignature barcodeSignature = signatures[0];
                    
                    // Pozisyonu ve boyutu güncelle
                    barcodeSignature.Left = 100;
                    barcodeSignature.Top = 100;
                    barcodeSignature.Width = 400;
                    barcodeSignature.Height = 100;
                    
                    // Güncellemeleri uygula
                    bool result = signature.Update(barcodeSignature);
                    
                    // Sonucu kontrol et
                    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();
        }
    }
}

Gelişmiş Barkod İmza Özelleştirmesi

GroupDocs.Signature, temel konum ve boyutun ötesinde barkod imzalarını özelleştirmek için ek seçenekler sunar:

Görünüm Özelliklerini Ayarlama

Barkodun görsel özelliklerini özelleştirin:

// Ön plan rengini (barkod rengini) ayarla
barcodeSignature.ForeColor = System.Drawing.Color.Blue;

// Arka plan rengini ayarla
barcodeSignature.BackgroundColor = System.Drawing.Color.LightYellow;

// Şeffaflığı ayarlayın
barcodeSignature.Opacity = 0.8;

Sınır Ekleme

Barkodu özel kenarlıklarla geliştirin:

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

Barkodun Döndürülmesi

Barkod imzasını belirli bir açıyla döndürün:

barcodeSignature.Angle = 30; // 30 derece döndür

Çözüm

GroupDocs.Signature for .NET, belgelerdeki barkod imzalarını güncellemek için güçlü ve esnek bir çözüm sunar. Geliştiriciler, bu eğitimde özetlenen adımları izleyerek .NET uygulamalarında barkod imza güncelleme işlevini verimli bir şekilde uygulayabilir, belge yönetimi ve otomasyon yeteneklerini geliştirebilirler.

GroupDocs.Signature, kapsamlı özellik seti ve sezgisel API’siyle geliştiricilerin, belge bütünlüğünü ve erişilebilirliğini garanti altına alırken modern iş uygulamalarının gereksinimlerini karşılayan gelişmiş belge imzalama çözümleri oluşturmasını sağlar.

SSS

Tek bir belge içerisinde birden fazla barkod imzasını güncelleyebilir miyim?

Evet, GroupDocs.Signature aynı belge içinde birden fazla barkod imzasını güncellemenize olanak tanır. İmzaları aradıktan sonra, ortaya çıkan listede gezinebilir ve her barkod imzasını ayrı ayrı güncelleyebilirsiniz.

GroupDocs.Signature farklı barkod formatlarını destekliyor mu?

Evet, GroupDocs.Signature doğrusal barkodlar (Kod 128, Kod 39, EAN, UPC, vb.) ve 2D barkodlar (QR Kodu, Veri Matrisi, PDF417, vb.) dahil olmak üzere çok çeşitli barkod formatlarını destekler.

GroupDocs.Signature for .NET için deneme sürümü mevcut mu?

Evet, ücretsiz deneme sürümünü şu adresten indirebilirsiniz: GroupDocs web sitesi Satın alma işlemi yapmadan önce kütüphanenin özelliklerini değerlendirmek.

Güncelleme yaparken bir barkod türünü diğerine dönüştürebilir miyim?

Güncellemeler sırasında barkod türleri arasında doğrudan dönüştürme desteklenmez. Ancak, mevcut barkodu silip istediğiniz formatta yeni bir barkod ekleyerek bunu başarabilirsiniz.

Bir barkodun güncellenmesi tarama kabiliyetini etkiler mi?

Boyut ve konum gibi barkod özelliklerini güncellerken, GroupDocs.Signature barkodun tarama bütünlüğünü korur. Ancak, aşırı küçük boyutlar veya önemli dönüş açıları bazı okuyucularda tarama performansını etkileyebilir.

GroupDocs.Signature for .NET için ek desteği nerede bulabilirim?

Aşağıdaki kaynaklardan kapsamlı destek alabilirsiniz: