Invoering

Teksthandtekeningen, hoewel vaak eenvoudiger dan digitale of elektronische handtekeningen, spelen een cruciale rol bij documentbeheer en -verificatie. Of het nu gaat om watermerken, voettekst of specifieke inhoudspatronen, het valideren van de aanwezigheid en integriteit van teksthandtekeningen is een belangrijk aspect van documentverificatieprocessen.

GroupDocs.Signature voor .NET biedt een krachtige API voor het verifiëren van teksthandtekeningen in documenten in diverse formaten. Deze uitgebreide tutorial begeleidt u bij het implementeren van tekstverificatiefunctionaliteit in uw .NET-applicaties, zodat uw documenten hun integriteit en authenticiteit behouden.

Vereisten

Voordat u de functionaliteit voor tekstverificatie implementeert, moet u ervoor zorgen dat aan de volgende vereisten is voldaan:

GroupDocs.Signature voor .NET: Download en installeer de bibliotheek van de downloadpagina.
.NET-ontwikkelomgeving: Visual Studio of een andere compatibele .NET-ontwikkelomgeving.
Basiskennis: Kennis van C#-programmering en .NET Framework-concepten.
Testdocument: Een document met teksthandtekeningen voor verificatiedoeleinden.

Vereiste naamruimten importeren

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

using System;
using GroupDocs.Signature;
using GroupDocs.Signature.Domain;
using GroupDocs.Signature.Options;

Laten we het tekstverificatieproces opsplitsen in duidelijke, beheersbare stappen:

Stap 1: Geef het documentpad op

// Pad naar het document met teksthandtekeningen
string filePath = "sample_multiple_signatures.docx";

Zorg ervoor dat u het voorbeeldpad vervangt door het daadwerkelijke pad naar uw document met teksthandtekeningen.

Stap 2: Initialiseer het handtekeningobject

// Maak een instantie van de Signature-klasse door het documentpad door te geven
using (Signature signature = new Signature(filePath))
{
    // Verificatiecode wordt hier geïmplementeerd
}

De Signature-klasse is het belangrijkste toegangspunt voor alle bewerkingen in de GroupDocs.Signature API.

Stap 3: Opties voor tekstverificatie configureren

// Definieer tekstverificatieopties
TextVerifyOptions options = new TextVerifyOptions()
{
    AllPages = true,                               // Controleer alle pagina's van het document
    SignatureImplementation = TextSignatureImplementation.Native,
    Text = "signature",                            // Te verifiëren tekst
    MatchType = TextMatchType.Contains             // Geef overeenkomende criteria op
};

Met de verificatieopties kunt u specifieke criteria voor het verificatieproces definiëren:

AllPages: Stel in op true om alle documentpagina’s te controleren
SignatureImplementation: Geef aan hoe de tekst wordt geïmplementeerd (Native of Sticker)
Text: De tekstinhoud die moet overeenkomen met het document
MatchType: De methode voor tekstmatching (Bevat, Exact, Begint met, enz.)

Stap 4: Verificatieproces uitvoeren

// Verificatie uitvoeren
VerificationResult result = signature.Verify(options);

Hiermee wordt het verificatieproces uitgevoerd op basis van de opties die u hebt opgegeven.

Stap 5: Verificatieresultaten verwerken

// Controleer het verificatieresultaat en voer de procedure dienovereenkomstig uit
if (result.IsValid)
{
    Console.WriteLine($"Document {filePath} contains valid text signatures!");
    
    // Informatie weergeven over succesvolle handtekeningen
    foreach (TextSignature textSignature in result.Succeeded)
    {
        Console.WriteLine($"\nFound valid text signature:");
        Console.WriteLine($"Text: {textSignature.Text}");
        Console.WriteLine($"Location: Page {textSignature.PageNumber}, {textSignature.Left}x{textSignature.Top}");
    }
}
else
{
    Console.WriteLine($"Document {filePath} failed verification process.");
    Console.WriteLine($"Number of failed signatures: {result.Failed.Count}");
}

Deze code controleert of de verificatie succesvol was en biedt gedetailleerde informatie over de teksthandtekeningen die geverifieerd zijn.

Volledig voorbeeld

Hier is een volledig werkend voorbeeld dat de verificatie van teksthandtekeningen demonstreert:

using System;
using GroupDocs.Signature;
using GroupDocs.Signature.Domain;
using GroupDocs.Signature.Options;

namespace GroupDocs.Signature.Examples
{
    class Program
    {
        static void Main(string[] args)
        {
            // Documentpad
            string filePath = "sample_multiple_signatures.docx";
            
            try
            {
                // Initialiseer Signature-instantie
                using (Signature signature = new Signature(filePath))
                {
                    // Verificatieopties instellen
                    TextVerifyOptions options = new TextVerifyOptions()
                    {
                        AllPages = true,
                        SignatureImplementation = TextSignatureImplementation.Native,
                        Text = "signature",
                        MatchType = TextMatchType.Contains
                    };
                    
                    // Controleer documenthandtekeningen
                    VerificationResult result = signature.Verify(options);
                    
                    // Resultaten van procesverificatie
                    if(result.IsValid)
                    {
                        Console.WriteLine($"\nDocument {filePath} was verified successfully!");
                        foreach (TextSignature item in result.Succeeded)
                        {
                            Console.WriteLine($"\nValid signature is found with text: {item.Text}");
                            Console.WriteLine($"Location: Page {item.PageNumber}, position {item.Left}x{item.Top}");
                        }
                    }
                    else
                    {
                        Console.WriteLine($"\nDocument {filePath} failed verification process.");
                    }
                }
            }
            catch (Exception ex)
            {
                Console.WriteLine($"Error: {ex.Message}");
            }
        }
    }
}

Geavanceerde verificatiescenario’s

GroupDocs.Signature biedt extra opties voor complexere verificatiescenario’s:

Reguliere expressies gebruiken voor verificatie

Voor flexibeler patroonherkenning kunt u reguliere expressies gebruiken:

TextVerifyOptions options = new TextVerifyOptions()
{
    Text = "Invoice\\s+#\\d{5,6}",  // Match patronen zoals "Factuur #12345"
    MatchType = TextMatchType.Regex
};

Tekst in specifieke documentgebieden verifiëren

U kunt de verificatie beperken tot specifieke delen van het document:

TextVerifyOptions options = new TextVerifyOptions()
{
    AllPages = false,
    PageNumber = 1,  // Alleen verifiëren op de eerste pagina
    
    // Definieer het gebied waarin u wilt zoeken (coördinaten in punten)
    PagesSetup = new PagesSetup() 
    { 
        FirstPage = true,
        LastPage = false,
        OddPages = false,
        EvenPages = false 
    },
    
    // Oppervlakte van de rechthoek in millimeters
    Rectangle = new Rectangle(10, 10, 100, 30),
    
    Text = "Confidential"
};

Meerdere tekstpatronen tegelijkertijd verifiëren

kunt meerdere verificatieopties maken om te controleren op verschillende tekstpatronen:

// Maak een lijst met verificatieopties
List<VerifyOptions> listOptions = new List<VerifyOptions>();

// Voeg eerste tekstverificatie toe
listOptions.Add(new TextVerifyOptions()
{
    Text = "Confidential",
    MatchType = TextMatchType.Exact
});

// Voeg een tweede tekstverificatie toe
listOptions.Add(new TextVerifyOptions()
{
    Text = "Do not copy",
    MatchType = TextMatchType.Contains
});

// Verifiëren met meerdere opties
VerificationResult result = signature.Verify(listOptions);

Tekst met een specifiek uiterlijk verifiëren

U kunt ook tekst controleren met specifieke opmaakkenmerken:

TextVerifyOptions options = new TextVerifyOptions()
{
    Text = "APPROVED",
    MatchType = TextMatchType.Exact,
    
    // Controleer specifieke uiterlijke kenmerken
    ForegroundColorRGB = System.Drawing.Color.Green,
    Font = new SignatureFont() { FontFamily = "Arial", FontSize = 12, Bold = true }
};

Aanbevolen procedures voor tekstverificatie

Kies de juiste overeenkomsttypen: Selecteer het juiste overeenkomsttype (Bevat, Exact, Regex) op basis van uw verificatievereisten.
Optimaliseer voor prestaties: bij grote documenten kunt u overwegen om specifieke pagina’s te verifiëren in plaats van het hele document.
Foutverwerking: implementeer een goede foutverwerking om onverwachte scenario’s op een elegante manier te beheren.
Houd rekening met hoofdlettergevoeligheid: houd rekening met hoofdlettergevoeligheid bij het vergelijken van tekst, vooral bij kritische verificaties.
Grondig testen: test de verificatie met verschillende documentformaten en tekstpatronen om compatibiliteit te garanderen.

Problemen met veelvoorkomende problemen oplossen

Tekst niet gedetecteerd

Controleer of de tekstopmaak of -codering de detectie beïnvloedt
Zorg ervoor dat de tekst daadwerkelijk als gewone tekst in het document aanwezig is (geen afbeelding)
Probeer andere matchingcriteria (Bevat in plaats van Exact)

Prestatieproblemen

Optimaliseer de verificatie door te targeten op specifieke pagina’s of gebieden
Gebruik specifiekere tekstpatronen om het aantal foutpositieve resultaten te verminderen

Verificatiefouten

Controleer of spaties, speciale tekens of opmaak de match beïnvloeden
Controleer of de tekst geen deel uitmaakt van een gescande afbeelding (waarvoor OCR nodig is)
Zorg ervoor dat het document niet is gewijzigd sinds de tekst is toegevoegd

Conclusie

Tekstverificatie is een veelzijdige en praktische aanpak voor documentauthenticatie die zelfstandig of in combinatie met andere verificatiemethoden kan worden gebruikt. GroupDocs.Signature voor .NET biedt een uitgebreide en gebruiksvriendelijke API voor het implementeren van robuuste tekstverificatiefunctionaliteit in uw .NET-applicaties.

Door deze stapsgewijze handleiding te volgen, hebt u geleerd hoe u:

Configureer en initialiseer het tekstverificatieproces
Geef verschillende verificatiecriteria op
Verificatieresultaten verwerken en interpreteren
Geavanceerde verificatiescenario’s implementeren

Met deze mogelijkheden kunt u veilige en betrouwbare documentverwerkingssystemen bouwen die de authenticiteit van tekst in verschillende documentformaten kunnen verifiëren.

Veelgestelde vragen

Kan GroupDocs.Signature tekst in gescande documenten verifiëren?

GroupDocs.Signature is primair ontworpen voor digitale tekstverificatie. Voor gescande documenten moet u eerst OCR-technologie (Optical Character Recognition) gebruiken om de gescande afbeeldingen naar tekst te converteren.

Welke documentformaten worden ondersteund voor tekstverificatie?

GroupDocs.Signature ondersteunt een breed scala aan documentformaten, waaronder PDF, Word-documenten (DOC, DOCX), Excel-spreadsheets (XLS, XLSX), PowerPoint-presentaties (PPT, PPTX), afbeeldingen en meer.

Kan ik opgemaakte tekst (vet, cursief, specifieke lettertypen) controleren?

Ja, GroupDocs.Signature biedt opties om tekst te controleren met specifieke opmaakkenmerken, waaronder lettertype, grootte, stijl (vet, cursief) en kleur.

Is het mogelijk om tekst in wachtwoordbeveiligde documenten te verifiëren?

Ja, GroupDocs.Signature biedt opties om wachtwoorden voor documenten op te geven bij het openen van beveiligde documenten ter verificatie.

Kan ik watermerken en achtergrondtekst controleren?

Ja, GroupDocs.Signature kan verschillende typen teksthandtekeningen verifiëren, waaronder watermerken en achtergrondtekst, afhankelijk van hoe deze in het document zijn geïmplementeerd.