Comment annuler la vérification d’un document à l’aide de GroupDocs.Signature pour .NET : Guide de gestion des événements

Introduction

Vous cherchez des moyens efficaces de gérer les tâches de vérification de documents de longue durée ? Avec GroupDocs.Signature pour .NET, vous pouvez gérer les événements de progression afin de surveiller et de contrôler efficacement ces processus. Ce guide vous explique comment mettre en œuvre un système qui annule les opérations en fonction de conditions spécifiques, comme un dépassement de délai de traitement.

Dans cet article, nous explorerons :

  • Configuration et installation de GroupDocs.Signature pour .NET
  • Implémentation de la gestion des événements de progression dans votre application
  • Annulation d’un processus en fonction de conditions spécifiques
  • Applications concrètes de ces fonctionnalités

Prérequis

Bibliothèques et dépendances requises

Pour suivre ce guide, assurez-vous d’avoir :

  • GroupDocs.Signature pour .NET:La bibliothèque principale pour les signatures de documents.
  • .NET Framework ou .NET Core:La version 4.6.1 ou ultérieure est recommandée.

Configuration requise pour l’environnement

Assurez-vous que votre environnement de développement est configuré avec Visual Studio ou un IDE compatible qui prend en charge les projets .NET.

Prérequis en matière de connaissances

Une connaissance de C# et des connaissances de base sur la gestion des événements dans .NET seront bénéfiques, mais pas obligatoires, car nous couvrirons ici l’essentiel.

Configuration de GroupDocs.Signature pour .NET

Pour commencer, installez la bibliothèque GroupDocs.Signature en utilisant l’une de ces méthodes :

.NET CLI

dotnet add package GroupDocs.Signature

Gestionnaire de paquets

Install-Package GroupDocs.Signature

Interface utilisateur du gestionnaire de packages NuGet Recherchez « GroupDocs.Signature » et installez la dernière version.

Acquisition de licence

Vous pouvez obtenir une licence d’essai gratuite pour tester toutes les fonctionnalités de GroupDocs.Signature. Pour une utilisation en production, vous pouvez envisager l’achat d’une licence :

  • Essai gratuit:Idéal pour les tests et le développement initial.
  • Licence temporaire: Utile si vous avez besoin de plus de temps au-delà de la période d’essai pour l’évaluation.
  • Achat:Obtenir une licence complète pour des projets commerciaux à long terme.

Initialisation de base

Une fois installé, initialisez GroupDocs.Signature dans votre projet pour commencer à travailler avec les signatures de documents :

using GroupDocs.Signature;

Cette configuration vous permet de créer des instances de Signature et commencez à explorer ses fonctionnalités.

Guide de mise en œuvre

Nous décomposerons la mise en œuvre en sections gérables axées sur différentes fonctionnalités.

Fonctionnalité 1 : Gestion des événements de progression

La gestion des événements de progression vous permet de suivre les processus en cours. Voici comment implémenter cette fonctionnalité :

Aperçu

Cette fonctionnalité permet à votre application de réagir aux changements dans la progression du processus, en fournissant un mécanisme pour annuler les opérations si nécessaire.

Mise en œuvre étape par étape

3.1 Configuration du gestionnaire d’événements Tout d’abord, définissez une méthode de gestionnaire d’événements qui vérifie si le temps de traitement dépasse 100 millisecondes (0,1 seconde).

private static void OnVerifyProgress(Signature sender, ProcessProgressEventArgs args)
{
    // Vérifiez si le temps de traitement dépasse 350 ticks.
    if (args.Ticks > 350) 
    {
        args.Cancel = true; // Annuler le processus.
        Console.WriteLine("Sign progress was canceled. Time spent {0} mlsec", args.Ticks);
    }
}

3.2 Attachement du gestionnaire d’événements Ensuite, attachez ce gestionnaire d’événements à votre Signature instance dans votre méthode de vérification.

using (Signature signature = new Signature(filePath))
{
    // Attachez un gestionnaire d’événements pour les événements de progression.
    signature.VerifyProgress += OnVerifyProgress;

    ...
}

3.3 Exécution du processus de vérification Enfin, exécutez le processus de vérification des documents tout en gérant une éventuelle annulation :

// Exécutez le processus de vérification.
VerificationResult result = signature.Verify(options);

if (result.IsValid)
{
    Console.WriteLine("Document verification was not canceled!");
}
else
{
    Console.WriteLine("Document verification was canceled successfully!");
}

Fonctionnalité 2 : Vérification des documents avec annulation

Cette section se concentre sur la vérification des documents tout en intégrant la gestion des événements de progression pour l’annulation.

Aperçu

En configurant des options de vérification et en attachant un gestionnaire de progression, vous pouvez annuler le processus s’il prend trop de temps, garantissant ainsi que votre application reste réactive.

4.1 Définir les options de vérification Configurer le TextVerifyOptions pour préciser quels aspects du document doivent être vérifiés :

TextVerifyOptions options = new TextVerifyOptions("Text signature")
{
    // Des configurations supplémentaires peuvent être spécifiées ici.
};

Applications pratiques

Il est essentiel de comprendre comment la gestion et l’annulation des événements de progression peuvent bénéficier à vos applications. Voici quelques cas d’utilisation :

  1. Traitement par lots: Gérez efficacement le temps de traitement dans les scénarios où plusieurs documents doivent être vérifiés.
  2. Systèmes de commentaires des utilisateurs:Fournir un retour d’information en temps réel aux utilisateurs lorsque les opérations prennent plus de temps que prévu, améliorant ainsi l’expérience utilisateur.
  3. Gestion des ressources: Annulez automatiquement les tâches de longue durée qui pourraient autrement solliciter les ressources système.
  4. Intégration avec l’automatisation des flux de travail:Utilisez ces fonctionnalités dans des flux de travail automatisés plus vastes pour garantir un fonctionnement fluide et sans retard.
  5. Environnements de test et de développement: Testez rapidement la manière dont votre application gère différents scénarios de traitement.

Considérations relatives aux performances

L’optimisation des performances lors de l’utilisation de GroupDocs.Signature est essentielle pour maintenir des opérations efficaces :

  • Utilisation des ressources: Soyez attentif à l’utilisation de la mémoire, en particulier lorsque vous manipulez des documents volumineux.

  • Meilleures pratiques:

    • Jeter Signature objets rapidement pour libérer des ressources.
    • Utilisez judicieusement les événements d’annulation pour éviter tout traitement inutile.

Conclusion

Dans ce tutoriel, vous avez appris à implémenter la gestion des événements de progression et l’annulation des processus lors de la vérification de documents à l’aide de GroupDocs.Signature pour .NET. Ces techniques peuvent considérablement améliorer l’efficacité et la réactivité de vos applications.

Dans une prochaine étape, envisagez d’explorer d’autres fonctionnalités offertes par GroupDocs.Signature, telles que les capacités de signature numérique et de recherche de signature, pour améliorer encore vos solutions de gestion de documents.

Section FAQ

Q1 : Quel est le but de la gestion des événements de progression dans GroupDocs.Signature ? Les événements de progression aident à surveiller et à contrôler les tâches de vérification de longue durée, vous permettant de les annuler si elles dépassent un certain seuil de temps.

Q2 : Comment puis-je attacher un gestionnaire d’événements pour la progression du processus ? Attachez-le à l’aide du VerifyProgress événement sur votre Signature exemple.

Q3 : Quels sont les scénarios courants dans lesquels l’annulation du traitement des documents est utile ? Utile dans le traitement par lots, les systèmes de rétroaction des utilisateurs et la gestion des ressources pour maintenir l’efficacité du système.

Q4 : Puis-je ajuster le seuil de temps pour annuler un processus ? Oui, modifiez la condition dans votre méthode de gestionnaire d’événements (par exemple, args.Ticks > 350) pour répondre à vos besoins.

Q5 : Que dois-je faire si mon application doit gérer plusieurs types de documents ? GroupDocs.Signature prend en charge différents formats de documents. Assurez-vous de configurer les options de vérification appropriées pour chaque type.

Ressources