Introduzione

GroupDocs.Signature per .NET è una soluzione completa per la firma dei documenti che consente agli sviluppatori di integrare potenti funzionalità di firma nelle loro applicazioni .NET. Grazie a questa versatile libreria, è possibile aggiungere, cercare, verificare e aggiornare senza problemi vari tipi di firme, incluse le firme testuali, in un’ampia gamma di formati di documento. Questo tutorial si concentra specificamente sull’aggiornamento delle firme testuali nei documenti, fornendo una guida dettagliata per un’implementazione senza problemi.

Prerequisiti

Prima di iniziare ad aggiornare la firma del testo con GroupDocs.Signature per .NET, assicurati di disporre dei seguenti prerequisiti:

  1. Visual Studio: installa l’ultima versione di Visual Studio IDE sul tuo sistema.
  2. GroupDocs.Signature per .NET: Scarica e installa la libreria GroupDocs.Signature per .NET da pagina di download.
  3. .NET Framework o .NET Core: assicurati di avere installato .NET Framework o .NET Core sul tuo computer di sviluppo.
  4. Conoscenza di base di C#: familiarità con i fondamenti della programmazione C#.

Importa spazi dei nomi

Prima di poter iniziare ad aggiornare le firme testuali nei documenti, è necessario importare gli spazi dei nomi necessari nel progetto. Questi spazi dei nomi forniscono l’accesso alle classi e ai metodi GroupDocs.Signature.

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

Passaggio 1: impostare il percorso del documento

Per prima cosa, stabilisci il percorso del documento contenente la firma testuale che desideri aggiornare.

string filePath = "sample_multiple_signatures.docx";

Questa riga specifica il percorso del documento sorgente. Sostituisci "sample_multiple_signatures.docx" con il percorso effettivo del tuo documento.

Passaggio 2: Copia il documento

Dal momento che il Update funziona con lo stesso documento, è buona norma creare una copia di backup del documento originale.

string fileName = Path.GetFileName(filePath);
string outputFilePath = Path.Combine("Your Document Directory", "UpdateText", fileName);
File.Copy(filePath, outputFilePath, true);

Questo frammento di codice crea una copia del documento sorgente in una directory specificata. Sostituisci "Your Document Directory" con il percorso effettivo in cui si desidera salvare il documento aggiornato.

Passaggio 3: inizializzare l’oggetto firma

Ora, inizializza il Signature oggetto con il percorso alla copia del documento.

using (Signature signature = new Signature(outputFilePath))
{
    // Il tuo codice qui
}

IL Signature La classe è il punto di ingresso principale per la funzionalità GroupDocs.Signature. La using La dichiarazione garantisce che le risorse vengano smaltite correttamente dopo l’uso.

Passaggio 4: Cerca le firme di testo

Prima di aggiornare una firma di testo, è necessario trovarla nel documento.

TextSearchOptions options = new TextSearchOptions();
List<TextSignature> signatures = signature.Search<TextSignature>(options);

Questo codice cerca tutte le firme testuali nel documento utilizzando le opzioni di ricerca predefinite. È possibile personalizzare la ricerca configurando proprietà aggiuntive di TextSearchOptions classe.

Passaggio 5: Aggiorna la firma del testo

Una volta trovate le firme di testo, puoi selezionarne una e aggiornarne le proprietà.

if (signatures.Count > 0)
{
    TextSignature textSignature = signatures[0];
    textSignature.Text = "John Walkman";
    textSignature.Left = textSignature.Left + 10;
    textSignature.Top = textSignature.Top + 10;
    textSignature.Width = 200;
    textSignature.Height = 100;
    bool result = signature.Update(textSignature);
    if (result)
    {
        Console.WriteLine($"Signature with Text '{textSignature.Text}' was updated in the document ['{fileName}'].");
    }
    else
    {
        Console.WriteLine($"Signature was not updated in the document! Signature with Text '{textSignature.Text}' was not found!");
    }
}

Questo codice:

  1. Controlla se sono state trovate firme di testo
  2. Prende la prima firma dall’elenco
  3. Modifica il contenuto del testo, la posizione (sinistra, alto) e le dimensioni (larghezza, altezza)
  4. Chiama il Update metodo per applicare le modifiche
  5. Visualizza un messaggio di successo o fallimento in base al risultato

Esempio completo

Ecco un esempio completo che mostra come aggiornare una firma di testo in un documento:

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

namespace UpdateTextSignature
{
    class Program
    {
        static void Main(string[] args)
        {
            // Percorso del documento
            string filePath = "sample_multiple_signatures.docx";
            
            // Copia documento
            string fileName = Path.GetFileName(filePath);
            string outputFilePath = Path.Combine("OutputDirectory", "UpdateText", fileName);
            Directory.CreateDirectory(Path.GetDirectoryName(outputFilePath));
            File.Copy(filePath, outputFilePath, true);
            
            // Inizializza l'oggetto Signature
            using (Signature signature = new Signature(outputFilePath))
            {
                // Cerca firme di testo
                TextSearchOptions options = new TextSearchOptions();
                List<TextSignature> signatures = signature.Search<TextSignature>(options);
                
                // Aggiorna la firma del testo
                if (signatures.Count > 0)
                {
                    TextSignature textSignature = signatures[0];
                    textSignature.Text = "John Walkman";
                    textSignature.Left = textSignature.Left + 10;
                    textSignature.Top = textSignature.Top + 10;
                    textSignature.Width = 200;
                    textSignature.Height = 100;
                    
                    // Applica modifiche
                    bool result = signature.Update(textSignature);
                    
                    // Controlla il risultato
                    if (result)
                    {
                        Console.WriteLine($"Signature with Text '{textSignature.Text}' was updated in the document ['{fileName}'].");
                    }
                    else
                    {
                        Console.WriteLine($"Signature was not updated in the document! Signature with Text '{textSignature.Text}' was not found!");
                    }
                }
                else
                {
                    Console.WriteLine("No text signatures found in the document.");
                }
            }
        }
    }
}

Personalizzazione avanzata della firma del testo

GroupDocs.Signature offre ampie opzioni di personalizzazione per le firme testuali. È possibile modificare diverse proprietà, tra cui:

  • Carattere: modifica la famiglia, la dimensione, lo stile e il colore del carattere
  • Bordo: aggiungi o modifica stili e colori del bordo
  • Sfondo: imposta i colori di sfondo o la trasparenza
  • Rotazione: ruota la firma del testo di un’angolazione specifica
  • Trasparenza: regola l’opacità della firma

Ecco un esempio di come personalizzare le proprietà del font:

textSignature.ForeColor = System.Drawing.Color.Blue;
textSignature.Font.FontFamily = "Arial";
textSignature.Font.FontSize = 16;
textSignature.Font.Bold = true;
textSignature.Font.Italic = true;
textSignature.Font.Underline = true;

Conclusione

GroupDocs.Signature per .NET offre una soluzione affidabile e flessibile per l’aggiornamento programmatico delle firme testuali nei documenti. Seguendo i passaggi descritti in questo tutorial, gli sviluppatori possono integrare in modo efficiente la funzionalità di aggiornamento delle firme testuali nelle loro applicazioni .NET, migliorando i processi di gestione e autenticazione dei documenti.

Grazie al suo set completo di funzionalità e all’API intuitiva, GroupDocs.Signature consente agli sviluppatori di creare soluzioni sofisticate per la firma di documenti che soddisfano i requisiti delle moderne applicazioni aziendali.

Domande frequenti

Posso aggiornare più firme di testo in un singolo documento?

Sì, è possibile aggiornare più firme di testo scorrendo l’elenco delle firme trovate e applicando le modifiche necessarie a ciascuna di esse singolarmente.

GroupDocs.Signature supporta altri tipi di firme oltre al testo?

Assolutamente sì! GroupDocs.Signature supporta vari tipi di firme, tra cui firme con immagine, digitali, con codice a barre, con codice QR e con timbro. Ogni tipo ha il proprio set di proprietà e metodi per la creazione, la ricerca e l’aggiornamento.

È disponibile una versione di prova di GroupDocs.Signature per .NET?

Sì, puoi scaricare una versione di prova gratuita da Qui per valutare le caratteristiche della biblioteca prima di effettuare un acquisto.

Posso personalizzare l’aspetto delle firme di testo?

Sì, GroupDocs.Signature offre ampie opzioni di personalizzazione per le firme di testo, tra cui proprietà del carattere (famiglia, dimensione, stile), colori, bordi, sfondi, rotazione e trasparenza.

GroupDocs.Signature per .NET funziona con tutti i formati di documento?

GroupDocs.Signature supporta un’ampia gamma di formati di documento, tra cui PDF, formati Microsoft Office (Word, Excel, PowerPoint), formati OpenDocument, immagini e altro ancora. Per un elenco completo, fare riferimento a documentazione.

Come posso ottenere supporto tecnico per GroupDocs.Signature?

È possibile ottenere supporto tecnico attraverso i seguenti canali: