Invoering

Barcodehandtekeningen worden veel gebruikt in digitale documentworkflows om gestructureerde gegevens te coderen, wat efficiënte tracking, identificatie en validatie mogelijk maakt. GroupDocs.Signature voor .NET is een uitgebreide oplossing voor het ondertekenen van documenten waarmee ontwikkelaars geavanceerde handtekeningfunctionaliteit in hun applicaties kunnen integreren, inclusief de mogelijkheid om bestaande barcodehandtekeningen in documenten bij te werken.

Deze tutorial richt zich specifiek op het bijwerken van barcodehandtekeningen in documenten met GroupDocs.Signature voor .NET. Of u nu de positie, grootte of gecodeerde gegevens van bestaande barcodes wilt wijzigen, deze handleiding begeleidt u door het proces met duidelijke codevoorbeelden en uitleg.

Vereisten

Voordat u updates voor streepjescodehandtekeningen implementeert met GroupDocs.Signature voor .NET, moet u ervoor zorgen dat aan de volgende vereisten is voldaan:

Ontwikkelomgeving: Een werkende .NET-ontwikkelomgeving, zoals Visual Studio 2017 of later.
GroupDocs.Signature-bibliotheek: de GroupDocs.Signature voor .NET-bibliotheek, die u kunt downloaden van de downloadpagina.
Basiskennis van C#: Kennis van C#-programmeerconcepten.
Voorbeelddocumenten: Document(en) met streepjescodehandtekeningen die u wilt bijwerken.

Naamruimten importeren

Begin met het importeren van de benodigde naamruimten om toegang te krijgen tot de GroupDocs.Signature-functionaliteit:

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

Laten we het proces voor het bijwerken van barcodehandtekeningen opsplitsen in beheersbare stappen:

Stap 1: Documentpaden instellen

Definieer eerst de paden voor uw brondocument en waar het bijgewerkte document wordt opgeslagen:

// Pad naar het brondocument met barcodehandtekeningen
string filePath = "sample_multiple_signatures.docx";

// Haal de bestandsnaam op voor de uitvoer
string fileName = Path.GetFileName(filePath);

// Definieer de uitvoermap en het bestandspad
string outputDirectory = Path.Combine("Your Document Directory", "UpdateBarcode");
string outputFilePath = Path.Combine(outputDirectory, fileName);

// Zorg ervoor dat de uitvoermap bestaat
Directory.CreateDirectory(outputDirectory);

Stap 2: Kopieer het brondocument

Omdat de updatebewerking het document rechtstreeks wijzigt, maakt u een kopie van het originele document om het te behouden:

// Maak een kopie van het originele document
File.Copy(filePath, outputFilePath, true);

Stap 3: Initialiseer de handtekeninginstantie

Maak een exemplaar van de Signature klasse om met het document te werken:

// Initialiseer het Signature-exemplaar met het pad naar het uitvoerbestand
using (Signature signature = new Signature(outputFilePath))
{
    // Hier worden handtekeningbewerkingen uitgevoerd
}

Stap 4: Configureer de opties voor barcode zoeken

Stel de zoekopties in om bestaande streepjescodehandtekeningen in het document te vinden:

// Zoekopties voor barcodehandtekeningen configureren
BarcodeSearchOptions options = new BarcodeSearchOptions()
{
    // U kunt filteren op tekstinhoud
    Text = "12345",
    MatchType = TextMatchType.Contains
    
    // Verwijder commentaar om op alle pagina's te zoeken
    // AllePagina's = waar
};

Stap 5: Zoeken naar barcodehandtekeningen

Gebruik de geconfigureerde zoekopties om streepjescodehandtekeningen in het document te vinden:

// Zoeken naar barcodehandtekeningen
List<BarcodeSignature> signatures = signature.Search<BarcodeSignature>(options);

Stap 6: Barcode-handtekeningeigenschappen bijwerken

Als er streepjescodehandtekeningen worden gevonden, werk dan indien nodig hun eigenschappen bij:

// Controleer of er handtekeningen zijn gevonden
if (signatures.Count > 0)
{
    // Ontvang de eerste barcodehandtekening
    BarcodeSignature barcodeSignature = signatures[0];
    
    // Positie bijwerken
    barcodeSignature.Left = 100;
    barcodeSignature.Top = 100;
    
    // Grootte bijwerken
    barcodeSignature.Width = 400;
    barcodeSignature.Height = 100;
    
    // Pas de updates toe
    bool result = signature.Update(barcodeSignature);
    
    // Controleer het resultaat
    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.");
}

Volledig voorbeeld

Hier is een volledig, functioneel voorbeeld dat laat zien hoe u een streepjescodehandtekening in een document kunt bijwerken:

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)
        {
            // Documentpad
            string filePath = "sample_multiple_signatures.docx";
            
            // Definieer uitvoerpad
            string fileName = Path.GetFileName(filePath);
            string outputDirectory = Path.Combine(Environment.CurrentDirectory, "UpdateBarcode");
            string outputFilePath = Path.Combine(outputDirectory, fileName);
            
            // Zorg ervoor dat de uitvoermap bestaat
            Directory.CreateDirectory(outputDirectory);
            
            // Maak een kopie van het originele document
            File.Copy(filePath, outputFilePath, true);
            
            // Initialiseer Signature-instantie
            using (Signature signature = new Signature(outputFilePath))
            {
                // Zoekopties configureren
                BarcodeSearchOptions options = new BarcodeSearchOptions
                {
                    Text = "12345",
                    MatchType = TextMatchType.Contains
                };
                
                // Zoeken naar barcodehandtekeningen
                List<BarcodeSignature> signatures = signature.Search<BarcodeSignature>(options);
                
                // Controleer of er handtekeningen zijn gevonden
                if (signatures.Count > 0)
                {
                    // Ontvang de eerste handtekening
                    BarcodeSignature barcodeSignature = signatures[0];
                    
                    // Positie en grootte bijwerken
                    barcodeSignature.Left = 100;
                    barcodeSignature.Top = 100;
                    barcodeSignature.Width = 400;
                    barcodeSignature.Height = 100;
                    
                    // Pas de updates toe
                    bool result = signature.Update(barcodeSignature);
                    
                    // Controleer resultaat
                    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();
        }
    }
}

Geavanceerde aanpassing van barcodehandtekeningen

GroupDocs.Signature biedt extra opties voor het aanpassen van barcodehandtekeningen die verder gaan dan de basispositie en -grootte:

Uiterlijke eigenschappen aanpassen

Pas de visuele aspecten van de barcode aan:

// Voorgrondkleur instellen (barcodekleur)
barcodeSignature.ForeColor = System.Drawing.Color.Blue;

// Achtergrondkleur instellen
barcodeSignature.BackgroundColor = System.Drawing.Color.LightYellow;

// Transparantie aanpassen
barcodeSignature.Opacity = 0.8;

Randen toevoegen

Verbeter de barcode met aangepaste randen:

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

De barcode roteren

Draai de streepjescodehandtekening naar een specifieke hoek:

barcodeSignature.Angle = 30; // 30 graden draaien

Conclusie

GroupDocs.Signature voor .NET biedt een krachtige en flexibele oplossing voor het bijwerken van barcodehandtekeningen in documenten. Door de stappen in deze tutorial te volgen, kunnen ontwikkelaars efficiënt functionaliteit voor het bijwerken van barcodehandtekeningen implementeren in hun .NET-applicaties, waardoor documentbeheer en automatiseringsmogelijkheden worden verbeterd.

Dankzij de uitgebreide functieset en intuïtieve API kunnen ontwikkelaars met GroupDocs.Signature geavanceerde oplossingen voor het ondertekenen van documenten bouwen die voldoen aan de vereisten van moderne zakelijke toepassingen en tegelijkertijd de integriteit en toegankelijkheid van documenten garanderen.

Veelgestelde vragen

Kan ik meerdere barcodehandtekeningen in één document bijwerken?

Ja, met GroupDocs.Signature kunt u meerdere barcodehandtekeningen in hetzelfde document bijwerken. Nadat u naar handtekeningen hebt gezocht, kunt u door de resulterende lijst bladeren en elke barcodehandtekening afzonderlijk bijwerken.

Ondersteunt GroupDocs.Signature verschillende barcodeformaten?

Ja, GroupDocs.Signature ondersteunt een groot aantal barcodeformaten, waaronder lineaire barcodes (Code 128, Code 39, EAN, UPC, enz.) en 2D-barcodes (QR-code, Data Matrix, PDF417, enz.).

Is er een proefversie beschikbaar voor GroupDocs.Signature voor .NET?

Ja, u kunt een gratis proefversie downloaden van de GroupDocs-website om de functies van de bibliotheek te evalueren voordat u tot aankoop overgaat.

Kan ik bij het updaten één barcodetype naar een ander type converteren?

Directe conversie tussen barcodetypen wordt niet ondersteund tijdens updates. U kunt dit echter wel doen door de bestaande barcode te verwijderen en een nieuwe toe te voegen met het gewenste formaat.

Heeft het bijwerken van een streepjescode invloed op de scancapaciteit?

Bij het bijwerken van barcode-eigenschappen zoals grootte en positie, behoudt GroupDocs.Signature de scanintegriteit van de barcode. Extreem kleine formaten of grote rotatiehoeken kunnen echter de scanprestaties bij sommige scanners beïnvloeden.

Waar kan ik aanvullende ondersteuning vinden voor GroupDocs.Signature voor .NET?

kunt uitgebreide ondersteuning krijgen via de volgende bronnen: