Introduzione

Nell’attuale panorama della gestione dei documenti digitali, la possibilità di cercare e convalidare le firme all’interno dei documenti è fondamentale per garantirne l’autenticità e la sicurezza. GroupDocs.Signature per .NET offre una soluzione potente per lavorare con vari tipi di firme, inclusi i codici a barre, in diversi formati di documento. Questo tutorial vi guiderà attraverso il processo di implementazione della funzionalità di ricerca delle firme tramite codice a barre nelle vostre applicazioni .NET utilizzando GroupDocs.Signature.

Prerequisiti

Prima di iniziare con questo tutorial, assicurati di avere i seguenti prerequisiti:

  1. GroupDocs.Signature per .NET: Scarica e installa l’ultima versione da Qui.
  2. Ambiente di sviluppo: configurare un ambiente di sviluppo .NET funzionante (ad esempio Visual Studio).
  3. Conoscenza di base di C#: familiarità con il linguaggio di programmazione C# e i concetti del framework .NET.
  4. Documenti di esempio: preparare documenti contenenti firme con codice a barre a scopo di test.

Importazione di spazi dei nomi

Per iniziare a implementare la funzionalità di ricerca della firma tramite codice a barre, è necessario importare gli spazi dei nomi necessari nel codice C#:

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

Ora scomponiamo il processo di ricerca delle firme tramite codice a barre in passaggi semplici e gestibili, con spiegazioni dettagliate:

Passaggio 1: definire il percorso del documento

Per prima cosa, specifica il percorso del documento in cui vuoi cercare le firme con codice a barre:

string filePath = "sample_multiple_signatures.docx";

Passaggio 2: inizializzare l’oggetto firma

Crea un’istanza di Signature classe passando il percorso del documento. Utilizzando un using dichiarazione garantisce il corretto smaltimento delle risorse:

using (Signature signature = new Signature(filePath))
{
    // Il codice per la ricerca della firma andrà qui
}

Passaggio 3: ricerca delle firme con codice a barre

Ora, cerca le firme del codice a barre all’interno del documento chiamando il Search metodo e specificando il tipo di firma come BarcodeSignature:

List<BarcodeSignature> signatures = signature.Search<BarcodeSignature>(SignatureType.Barcode);

Passaggio 4: visualizzare i risultati

Scorrere le firme dei codici a barre trovate e visualizzarne i dettagli:

Console.WriteLine($"\nSource document ['{filePath}'] contains the following barcode signatures:");
foreach (var barcodeSignature in signatures)
{
    Console.WriteLine($"Barcode signature found at page {barcodeSignature.PageNumber} with type {barcodeSignature.EncodeType.TypeName} and text '{barcodeSignature.Text}'");
}

Esempio completo

Ecco un esempio completo e funzionante che riassume tutti i passaggi:

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

namespace BarcodeSignatureSearch
{
    class Program
    {
        static void Main(string[] args)
        {
            // Percorso del documento
            string filePath = "sample_multiple_signatures.docx";
            
            // Inizializza l'istanza della firma
            using (Signature signature = new Signature(filePath))
            {
                // Cerca le firme con codice a barre nel documento
                List<BarcodeSignature> signatures = signature.Search<BarcodeSignature>(SignatureType.Barcode);
                
                // Visualizza i risultati della ricerca
                Console.WriteLine($"\nSource document ['{filePath}'] contains the following barcode signatures:");
                foreach (var barcodeSignature in signatures)
                {
                    Console.WriteLine($"Barcode signature found at page {barcodeSignature.PageNumber} with type {barcodeSignature.EncodeType.TypeName} and text '{barcodeSignature.Text}'");
                }
            }
        }
    }
}

Opzioni di ricerca avanzate

Per ricerche più precise sulla firma del codice a barre, è possibile utilizzare BarcodeSearchOptions per personalizzare i criteri di ricerca:

// Crea opzioni di ricerca
BarcodeSearchOptions options = new BarcodeSearchOptions
{
    // Cerca in tutte le pagine
    AllPages = true,
    
    // Specificare il testo da abbinare
    Text = "Invoice",
    
    // Specificare il tipo di corrispondenza (Contiene, Esatto, Inizia con, Termina con)
    MatchType = TextMatchType.Contains,
    
    // Specificare i tipi di codice a barre specifici da cercare
    EncodeType = BarcodeTypes.Code128
};

// Cerca con opzioni specifiche
List<BarcodeSignature> signatures = signature.Search<BarcodeSignature>(options);

Conclusione

In questo tutorial, abbiamo esplorato come cercare firme con codice a barre all’interno dei documenti utilizzando GroupDocs.Signature per .NET. Seguendo la guida passo passo e utilizzando gli esempi di codice forniti, è possibile integrare facilmente questa funzionalità nelle applicazioni .NET, migliorando la sicurezza dei documenti e i processi di verifica. GroupDocs.Signature fornisce un framework robusto per lavorare con diversi tipi di firme, rendendolo una scelta eccellente per i sistemi di gestione documentale in cui autenticità e integrità sono fondamentali.

Domande frequenti

GroupDocs.Signature può cercare più tipi di firme contemporaneamente?

Sì, GroupDocs.Signature può cercare più tipi di firma (codice a barre, codice QR, testo, firme digitali, ecc.) in un’unica operazione utilizzando Search metodo con un elenco di diverse opzioni di ricerca.

Quali formati di documento sono supportati per la ricerca della firma tramite codice a barre?

GroupDocs.Signature supporta un’ampia gamma di formati di documenti, tra cui PDF, Word (DOC, DOCX), Excel (XLS, XLSX), PowerPoint (PPT, PPTX), immagini e molti altri.

Posso personalizzare i criteri di ricerca dei codici a barre?

Sì, puoi personalizzare i criteri di ricerca utilizzando BarcodeSearchOptions per specificare parametri quali testo da abbinare, tipo di corrispondenza, tipi di codici a barre specifici e se effettuare la ricerca su tutte le pagine o su pagine specifiche.

Esiste un limite al numero di firme con codice a barre che possono essere rilevate?

Non esiste un limite specifico al numero di firme con codice a barre che possono essere rilevate. GroupDocs.Signature troverà tutte le firme con codice a barre che corrispondono ai criteri di ricerca.

Posso cercare firme con codice a barre nei documenti protetti da password?

Sì, GroupDocs.Signature consente di cercare firme con codice a barre in documenti protetti da password fornendo la password durante l’inizializzazione Signature oggetto.

Vedi anche