Как отменить проверку документа с помощью GroupDocs.Signature для .NET: руководство по обработке событий

Введение

Ищете эффективные способы управления длительными задачами проверки документов? GroupDocs.Signature для .NET позволяет обрабатывать события хода выполнения для эффективного мониторинга и контроля этих процессов. Это руководство покажет вам, как реализовать систему, которая отменяет операции при возникновении определённых условий, например, превышения порогового времени обработки.

В этой статье мы рассмотрим:

  • Настройка и установка GroupDocs.Signature для .NET
  • Реализация обработки событий прогресса в вашем приложении
  • Отмена процесса на основании определенных условий
  • Реальные применения этих функций

Предпосылки

Необходимые библиотеки и зависимости

Чтобы следовать этому руководству, убедитесь, что у вас есть:

  • GroupDocs.Signature для .NET: Основная библиотека для подписей документов.
  • .NET Framework или .NET Core: Рекомендуется версия 4.6.1 или более поздняя.

Требования к настройке среды

Убедитесь, что ваша среда разработки настроена на Visual Studio или совместимую IDE, которая поддерживает проекты .NET.

Необходимые знания

Знакомство с C# и базовые знания обработки событий в .NET будут полезны, но не обязательны, поскольку здесь мы рассмотрим самые основные моменты.

Настройка GroupDocs.Signature для .NET

Для начала установите библиотеку GroupDocs.Signature одним из следующих способов:

.NET CLI

dotnet add package GroupDocs.Signature

Менеджер пакетов

Install-Package GroupDocs.Signature

Пользовательский интерфейс менеджера пакетов NuGet Найдите «GroupDocs.Signature» и установите последнюю версию.

Приобретение лицензии

Вы можете получить бесплатную пробную лицензию для полного тестирования возможностей GroupDocs.Signature. Для использования в производственной среде рекомендуется приобрести лицензию:

  • Бесплатная пробная версия: Идеально подходит для тестирования и первоначальной разработки.
  • Временная лицензия: Полезно, если вам нужно больше времени для оценки после окончания пробного периода.
  • Покупка: Получите полную лицензию для долгосрочных коммерческих проектов.

Базовая инициализация

После установки инициализируйте GroupDocs.Signature в своем проекте, чтобы начать работать с подписями документов:

using GroupDocs.Signature;

Эта настройка позволяет вам создавать экземпляры Signature и начните изучать его особенности.

Руководство по внедрению

Мы разобьем реализацию на управляемые разделы, уделяя особое внимание различным функциям.

Функция 1: Обработка событий прогресса

Возможность обработки событий хода выполнения позволяет отслеживать текущие процессы. Вот как можно реализовать эту функцию:

Обзор

Эта функция позволяет вашему приложению реагировать на изменения в ходе процесса, предоставляя механизм для отмены операций при необходимости.

Пошаговая реализация

3.1 Настройка обработчика событий Сначала определите метод обработчика событий, который проверяет, превышает ли время обработки 100 миллисекунд (0,1 секунды).

private static void OnVerifyProgress(Signature sender, ProcessProgressEventArgs args)
{
    // Проверьте, превышает ли время обработки 350 тиков.
    if (args.Ticks > 350) 
    {
        args.Cancel = true; // Отменить процесс.
        Console.WriteLine("Sign progress was canceled. Time spent {0} mlsec", args.Ticks);
    }
}

3.2 Присоединение обработчика событий Затем присоедините этот обработчик событий к вашему Signature экземпляр в вашем методе проверки.

using (Signature signature = new Signature(filePath))
{
    // Присоедините обработчик событий для событий прогресса.
    signature.VerifyProgress += OnVerifyProgress;

    ...
}

3.3 Выполнение процесса проверки Наконец, выполните процесс проверки документов, одновременно обрабатывая возможную отмену:

// Выполните процедуру проверки.
VerificationResult result = signature.Verify(options);

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

Функция 2: Проверка документов с отменой

В этом разделе основное внимание уделяется проверке документов с учетом обработки событий при отмене.

Обзор

Настроив параметры проверки и прикрепив обработчик хода выполнения, вы сможете отменить процесс, если он займет слишком много времени, гарантируя тем самым, что ваше приложение останется отзывчивым.

4.1 Определение параметров проверки Настройте TextVerifyOptions чтобы указать, какие аспекты документа требуют проверки:

TextVerifyOptions options = new TextVerifyOptions("Text signature")
{
    // Дополнительные конфигурации можно указать здесь.
};

Практические применения

Крайне важно понимать, как обработка и отмена событий прогресса могут принести пользу вашим приложениям. Вот несколько примеров использования:

  1. Пакетная обработка: Эффективно управляйте временем обработки в ситуациях, когда требуется проверка нескольких документов.
  2. Системы обратной связи с пользователями: Предоставляйте пользователям обратную связь в режиме реального времени, если операции занимают больше времени, чем ожидалось, что улучшает пользовательский опыт.
  3. Управление ресурсами: Автоматически отменять длительные задачи, которые в противном случае могут нагружать системные ресурсы.
  4. Интеграция с автоматизацией рабочих процессов: Используйте эти функции в крупных автоматизированных рабочих процессах, чтобы обеспечить бесперебойную работу без задержек.
  5. Среды тестирования и разработки: Быстро протестируйте, как ваше приложение обрабатывает различные сценарии обработки.

Соображения производительности

Оптимизация производительности при использовании GroupDocs.Signature имеет решающее значение для поддержания эффективной работы:

  • Использование ресурсов: Будьте внимательны к использованию памяти, особенно при работе с большими документами.

  • Лучшие практики:

    • Распоряжаться Signature объекты быстро освобождают ресурсы.
    • Используйте события отмены разумно, чтобы избежать ненужной обработки.

Заключение

В этом руководстве вы узнали, как реализовать обработку событий прогресса и отмену процесса при проверке документов с помощью GroupDocs.Signature для .NET. Эти методы могут значительно повысить эффективность и скорость отклика ваших приложений.

В качестве следующего шага рассмотрите возможность изучения других функций, предлагаемых GroupDocs.Signature, таких как возможности цифровой подписи и поиска подписей, чтобы еще больше усовершенствовать ваши решения по управлению документами.

Раздел часто задаваемых вопросов

В1: Какова цель обработки событий хода выполнения в GroupDocs.Signature? События хода выполнения помогают отслеживать и контролировать длительные задачи проверки, позволяя отменять их, если они превышают определенный временной порог.

В2: Как прикрепить обработчик событий для отслеживания хода процесса? Прикрепите его с помощью VerifyProgress событие на вашем Signature пример.

В3: В каких типичных сценариях отмена обработки документа может быть полезна? Полезно для пакетной обработки, систем обратной связи с пользователями и управления ресурсами для поддержания эффективности системы.

В4: Могу ли я настроить временной порог для отмены процесса? Да, измените условие в методе обработчика событий (например, args.Ticks > 350) в соответствии с вашими требованиями.

В5: Что делать, если моему приложению необходимо обрабатывать несколько типов документов? GroupDocs.Signature поддерживает различные форматы документов. Убедитесь, что вы настроили соответствующие параметры проверки для каждого типа.

Ресурсы