Introduction

GroupDocs.Signature pour .NET est une solution complète de signature de documents qui permet aux développeurs d’intégrer de puissantes fonctionnalités de signature à leurs applications .NET. Grâce à cette bibliothèque polyvalente, vous pouvez facilement ajouter, rechercher, vérifier et mettre à jour différents types de signatures, y compris textuelles, dans une grande variété de formats de documents. Ce tutoriel se concentre spécifiquement sur la mise à jour des signatures textuelles dans les documents et vous guide étape par étape pour une mise en œuvre fluide.

Prérequis

Avant de vous lancer dans la mise à jour des signatures de texte avec GroupDocs.Signature pour .NET, assurez-vous de disposer des conditions préalables suivantes :

Visual Studio : installez la dernière version de Visual Studio IDE sur votre système.
GroupDocs.Signature pour .NET : téléchargez et installez la bibliothèque GroupDocs.Signature pour .NET à partir du page de téléchargement.
.NET Framework ou .NET Core : assurez-vous que .NET Framework ou .NET Core est installé sur votre machine de développement.
Connaissances de base en C# : Familiarité avec les fondamentaux de la programmation C#.

Importer des espaces de noms

Avant de pouvoir mettre à jour les signatures textuelles de vos documents, vous devez importer les espaces de noms nécessaires dans votre projet. Ces espaces donnent accès aux classes et méthodes GroupDocs.Signature.

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

Étape 1 : Configurer le chemin du document

Tout d’abord, établissez le chemin d’accès au document contenant la signature de texte que vous souhaitez mettre à jour.

string filePath = "sample_multiple_signatures.docx";

Cette ligne spécifie le chemin d’accès à votre document source. Remplacer "sample_multiple_signatures.docx" avec le chemin réel vers votre document.

Étape 2 : Copier le document

Depuis le Update la méthode fonctionne avec le même document, c’est une bonne pratique de créer une copie de sauvegarde de votre document d’origine.

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

Cet extrait de code crée une copie de votre document source dans un répertoire spécifié. Remplacer "Your Document Directory" avec le chemin réel où vous souhaitez enregistrer le document mis à jour.

Étape 3 : Initialiser l’objet Signature

Maintenant, initialisez le Signature objet avec le chemin vers votre copie de document.

using (Signature signature = new Signature(outputFilePath))
{
    // Votre code ici
}

Le Signature La classe est le point d’entrée principal vers la fonctionnalité GroupDocs.Signature. using La déclaration garantit que les ressources sont correctement éliminées après utilisation.

Étape 4 : Rechercher des signatures de texte

Avant de mettre à jour une signature de texte, vous devez la trouver dans le document.

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

Ce code recherche toutes les signatures textuelles du document à l’aide des options de recherche par défaut. Vous pouvez personnaliser la recherche en configurant des propriétés supplémentaires. TextSearchOptions classe.

Étape 5 : Mettre à jour la signature du texte

Une fois que vous avez trouvé les signatures de texte, vous pouvez en sélectionner une et mettre à jour ses propriétés.

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!");
    }
}

Ce code :

Vérifie si des signatures de texte ont été trouvées
Prend la première signature de la liste
Modifie son contenu textuel, sa position (gauche, haut) et sa taille (largeur, hauteur)
Appelle le Update méthode pour appliquer les modifications
Affiche un message de réussite ou d’échec en fonction du résultat

Exemple complet

Voici un exemple complet qui montre comment mettre à jour une signature de texte dans un document :

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)
        {
            // Chemin du document
            string filePath = "sample_multiple_signatures.docx";
            
            // Copier le document
            string fileName = Path.GetFileName(filePath);
            string outputFilePath = Path.Combine("OutputDirectory", "UpdateText", fileName);
            Directory.CreateDirectory(Path.GetDirectoryName(outputFilePath));
            File.Copy(filePath, outputFilePath, true);
            
            // Initialiser l'objet Signature
            using (Signature signature = new Signature(outputFilePath))
            {
                // Rechercher des signatures de texte
                TextSearchOptions options = new TextSearchOptions();
                List<TextSignature> signatures = signature.Search<TextSignature>(options);
                
                // Mettre à jour la signature du texte
                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;
                    
                    // Appliquer les modifications
                    bool result = signature.Update(textSignature);
                    
                    // Vérifier le résultat
                    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.");
                }
            }
        }
    }
}

Personnalisation avancée de la signature de texte

GroupDocs.Signature offre de nombreuses options de personnalisation pour les signatures textuelles. Vous pouvez modifier diverses propriétés, telles que :

Police : modifiez la famille de polices, la taille, le style et la couleur
Bordure : ajouter ou modifier les styles et les couleurs des bordures
Arrière-plan : définir les couleurs d’arrière-plan ou la transparence
Rotation : faites pivoter la signature du texte selon un angle spécifique
Transparence : Ajuster l’opacité de la signature

Voici un exemple de personnalisation des propriétés de police :

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;

Conclusion

GroupDocs.Signature pour .NET offre une solution robuste et flexible pour la mise à jour programmatique des signatures textuelles dans les documents. En suivant les étapes décrites dans ce tutoriel, les développeurs peuvent intégrer efficacement la mise à jour des signatures textuelles à leurs applications .NET, améliorant ainsi la gestion des documents et les processus d’authentification.

Avec son ensemble complet de fonctionnalités et son API conviviale, GroupDocs.Signature permet aux développeurs de créer des solutions de signature de documents sophistiquées qui répondent aux exigences des applications commerciales modernes.

FAQ

Puis-je mettre à jour plusieurs signatures de texte dans un seul document ?

Oui, vous pouvez mettre à jour plusieurs signatures de texte en parcourant la liste des signatures trouvées et en appliquant les modifications nécessaires à chacune d’elles individuellement.

GroupDocs.Signature prend-il en charge d’autres types de signatures en plus du texte ?

Absolument ! GroupDocs.Signature prend en charge différents types de signatures, notamment les signatures d’image, numériques, de codes-barres, de codes QR et de tampons. Chaque type possède ses propres propriétés et méthodes de création, de recherche et de mise à jour.

Existe-t-il une version d’essai disponible pour GroupDocs.Signature pour .NET ?

Oui, vous pouvez télécharger une version d’essai gratuite à partir de ici pour évaluer les fonctionnalités de la bibliothèque avant de procéder à un achat.

Puis-je personnaliser l’apparence des signatures de texte ?

Oui, GroupDocs.Signature fournit de nombreuses options de personnalisation pour les signatures de texte, notamment les propriétés de police (famille, taille, style), les couleurs, les bordures, les arrière-plans, la rotation et la transparence.

GroupDocs.Signature pour .NET fonctionne-t-il avec tous les formats de documents ?

GroupDocs.Signature prend en charge un large éventail de formats de documents, notamment les PDF, les formats Microsoft Office (Word, Excel, PowerPoint), les formats OpenDocument, les images, etc. Pour une liste complète, consultez la documentation.

Comment puis-je obtenir une assistance technique pour GroupDocs.Signature ?

Vous pouvez obtenir une assistance technique via les canaux suivants :