Jak zrušit ověření dokumentu pomocí GroupDocs.Signature pro .NET: Průvodce zpracováním událostí

Zavedení

Hledáte efektivní způsoby, jak spravovat dlouhodobé úlohy ověřování dokumentů? S GroupDocs.Signature pro .NET můžete zpracovávat události průběhu a efektivně monitorovat a řídit tyto procesy. Tato příručka vám ukáže, jak implementovat systém, který ruší operace na základě specifických podmínek, jako je překročení prahové hodnoty doby zpracování.

V tomto článku prozkoumáme:

  • Nastavení a instalace GroupDocs.Signature pro .NET
  • Implementace zpracování událostí progress ve vaší aplikaci
  • Zrušení procesu na základě specifických podmínek
  • Reálné aplikace těchto funkcí

Předpoklady

Požadované knihovny a závislosti

Abyste mohli postupovat podle této příručky, ujistěte se, že máte:

  • GroupDocs.Signature pro .NETZákladní knihovna pro podpisy dokumentů.
  • .NET Framework nebo .NET CoreDoporučuje se verze 4.6.1 nebo novější.

Požadavky na nastavení prostředí

Ujistěte se, že vaše vývojové prostředí je nastavené pomocí sady Visual Studio nebo kompatibilního IDE, které podporuje projekty .NET.

Předpoklady znalostí

Znalost jazyka C# a základní znalosti ošetřování událostí v .NET budou výhodou, ale nejsou povinné, protože zde probereme základy.

Nastavení GroupDocs.Signature pro .NET

Chcete-li začít, nainstalujte knihovnu GroupDocs.Signature pomocí jedné z těchto metod:

Rozhraní příkazového řádku .NET

dotnet add package GroupDocs.Signature

Správce balíčků

Install-Package GroupDocs.Signature

Uživatelské rozhraní Správce balíčků NuGet Vyhledejte „GroupDocs.Signature“ a nainstalujte nejnovější verzi.

Získání licence

Můžete si pořídit bezplatnou zkušební licenci a otestovat všechny funkce GroupDocs.Signature. Pro produkční použití můžete zvážit zakoupení licence:

  • Bezplatná zkušební verzeIdeální pro testování a počáteční vývoj.
  • Dočasná licenceUžitečné, pokud potřebujete k vyhodnocení více času i po uplynutí zkušební doby.
  • NákupZískejte plnou licenci pro dlouhodobé komerční projekty.

Základní inicializace

Po instalaci inicializujte GroupDocs.Signature ve vašem projektu, abyste mohli začít pracovat s podpisy dokumentů:

using GroupDocs.Signature;

Toto nastavení umožňuje vytvářet instance Signature a začněte zkoumat jeho vlastnosti.

Průvodce implementací

Implementaci rozdělíme do zvládnutelných sekcí zaměřených na různé funkce.

Funkce 1: Zpracování událostí průběhu

Schopnost zpracovávat události průběhu vám umožňuje sledovat probíhající procesy. Zde je návod, jak tuto funkci implementovat:

Přehled

Tato funkce umožňuje vaší aplikaci reagovat na změny v průběhu procesu a poskytuje mechanismus pro zrušení operací v případě potřeby.

Postupná implementace

3.1 Nastavení obslužné rutiny událostí Nejprve definujte metodu obslužné rutiny události, která kontroluje, zda doba zpracování překročí 100 milisekund (0,1 sekundy).

private static void OnVerifyProgress(Signature sender, ProcessProgressEventArgs args)
{
    // Zkontrolujte, zda doba zpracování nepřesahuje 350 tiků.
    if (args.Ticks > 350) 
    {
        args.Cancel = true; // Zrušte proces.
        Console.WriteLine("Sign progress was canceled. Time spent {0} mlsec", args.Ticks);
    }
}

3.2 Připojení obslužné rutiny události Dále připojte tuto obslužnou rutinu události k vašemu Signature instance v rámci vaší ověřovací metody.

using (Signature signature = new Signature(filePath))
{
    // Připojte obslužnou rutinu události pro události průběhu.
    signature.VerifyProgress += OnVerifyProgress;

    ...
}

3.3 Provedení ověřovacího procesu Nakonec proveďte proces ověření dokumentů a zároveň zpracujte případné zrušení:

// Proveďte ověřovací proces.
VerificationResult result = signature.Verify(options);

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

Funkce 2: Ověření dokumentu se zrušením

Tato část se zaměřuje na ověřování dokumentů a zároveň zahrnuje zpracování událostí průběhu pro zrušení.

Přehled

Nastavením možností ověřování a připojením obslužné rutiny průběhu můžete proces zrušit, pokud trvá příliš dlouho, a zajistit tak, aby vaše aplikace zůstala responzivní.

4.1 Definování možností ověření Nastavte TextVerifyOptions specifikovat, které aspekty dokumentu je třeba ověřit:

TextVerifyOptions options = new TextVerifyOptions("Text signature")
{
    // Zde lze specifikovat další konfigurace.
};

Praktické aplikace

Pochopení toho, jak může zpracování událostí průběhu a jejich zrušení prospět vašim aplikacím, je zásadní. Zde je několik případů použití:

  1. Dávkové zpracováníEfektivně řiďte dobu zpracování v situacích, kdy je třeba ověřit více dokumentů.
  2. Systémy zpětné vazby od uživatelůPoskytujte uživatelům zpětnou vazbu v reálném čase, když operace trvají déle, než se očekávalo, a zlepšujte tak uživatelský komfort.
  3. Správa zdrojů: Automaticky ruší dlouhodobě spuštěné úlohy, které by jinak mohly zatěžovat systémové prostředky.
  4. Integrace s automatizací pracovních postupůTyto funkce můžete využít v rámci rozsáhlejších automatizovaných pracovních postupů k zajištění plynulého provozu bez zpoždění.
  5. Testovací a vývojová prostředíRychle otestujte, jak vaše aplikace zvládá různé scénáře zpracování.

Úvahy o výkonu

Optimalizace výkonu při používání GroupDocs.Signature je klíčová pro udržení efektivního provozu:

  • Využití zdrojůDávejte pozor na využití paměti, zejména při práci s velkými dokumenty.

  • Nejlepší postupy:

    • Disponovat Signature objekty neprodleně uvolnit zdroje.
    • Události zrušení používejte uvážlivě, abyste předešli zbytečnému zpracování.

Závěr

V tomto tutoriálu jste se naučili, jak implementovat zpracování událostí průběhu a rušení procesů při ověřování dokumentů pomocí GroupDocs.Signature pro .NET. Tyto techniky mohou výrazně zvýšit efektivitu a rychlost odezvy vašich aplikací.

Jako další krok zvažte prozkoumání dalších funkcí nabízených službou GroupDocs.Signature, jako je digitální podepisování a vyhledávání podpisů, abyste dále vylepšili svá řešení pro správu dokumentů.

Sekce Často kladených otázek

Q1: Jaký je účel zpracování událostí průběhu v GroupDocs.Signature? Události průběhu pomáhají monitorovat a řídit dlouhodobé ověřovací úlohy a umožňují je zrušit, pokud překročí určitý časový limit.

Q2: Jak připojím obslužnou rutinu události pro průběh procesu? Připevněte jej pomocí VerifyProgress událost na vašem Signature instance.

Q3: Jaké jsou běžné scénáře, kdy je zrušení zpracování dokumentů užitečné? Užitečné v dávkovém zpracování, systémech zpětné vazby od uživatelů a správě zdrojů pro udržení efektivity systému.

Q4: Mohu upravit časový limit pro zrušení procesu? Ano, upravte podmínku v metodě obslužné rutiny události (např. args.Ticks > 350) aby vyhovovaly vašim požadavkům.

Q5: Co mám dělat, když moje aplikace potřebuje zpracovat více typů dokumentů? GroupDocs.Signature podporuje různé formáty dokumentů. Ujistěte se, že pro každý typ nakonfigurujete vhodné možnosti ověření.

Zdroje