GroupDocs.Signature for .NET を使用してドキュメント検証をキャンセルする方法: イベント処理ガイド

導入

長時間かかる文書検証タスクを効率的に管理する方法をお探しですか？GroupDocs.Signature for .NETを使えば、進捗イベントを処理してこれらのプロセスを効果的に監視・制御できます。このガイドでは、処理時間が閾値を超えるなど、特定の条件に基づいて操作をキャンセルするシステムの実装方法をご紹介します。

この記事では、次の内容について説明します。

GroupDocs.Signature for .NET のセットアップとインストール
アプリケーションに進捗イベント処理を実装する
特定の条件に基づいてプロセスをキャンセルする
これらの機能の実際の応用

前提条件

必要なライブラリと依存関係

このガイドに従うには、次のものを用意してください。

.NET 用 GroupDocs.Signature: ドキュメント署名のコアライブラリ。
.NET Framework または .NET Core: バージョン4.6.1以降を推奨します。

環境設定要件

開発環境が Visual Studio または .NET プロジェクトをサポートする互換性のある IDE で設定されていることを確認します。

知識の前提条件

C# の知識と .NET でのイベント処理に関する基本的な知識があれば有利ですが、必須ではありません。ここでは基本的な内容について説明します。

GroupDocs.Signature を .NET 用にセットアップする

開始するには、次のいずれかの方法で GroupDocs.Signature ライブラリをインストールします。

.NET CLI

dotnet add package GroupDocs.Signature

パッケージマネージャー

Install-Package GroupDocs.Signature

NuGet パッケージマネージャー UI 「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")
{
    // ここで追加の構成を指定できます。
};

実用的な応用

進捗イベントの処理とキャンセルがアプリケーションにどのようなメリットをもたらすかを理解することは非常に重要です。以下にいくつかのユースケースをご紹介します。

バッチ処理複数のドキュメントの検証が必要なシナリオで処理時間を効率的に管理します。
ユーザーフィードバックシステム操作に予想よりも時間がかかった場合にユーザーにリアルタイムのフィードバックを提供し、ユーザーエクスペリエンスを向上させます。
リソース管理システムリソースに負担をかける可能性がある長時間実行タスクを自動的にキャンセルします。
ワークフロー自動化との統合大規模な自動化ワークフロー内でこれらの機能を使用することで、遅延のないスムーズな操作が保証されます。
テストおよび開発環境アプリケーションがさまざまな処理シナリオをどのように処理するかを簡単にテストします。

パフォーマンスに関する考慮事項

GroupDocs.Signature を使用する際のパフォーマンスを最適化することは、効率的な操作を維持するために重要です。

リソースの使用状況特に大きなドキュメントを扱う場合には、メモリ使用量に注意してください。
ベストプラクティス：
- 処分する Signature リソースを解放するためにすぐにオブジェクトを返します。
- 不要な処理を防ぐために、キャンセルイベントを慎重に使用してください。

結論

このチュートリアルでは、GroupDocs.Signature for .NET を使用して、ドキュメント検証における進捗イベント処理とプロセスキャンセルを実装する方法を学びました。これらのテクニックは、アプリケーションの効率と応答性を大幅に向上させることができます。

次のステップとして、デジタル署名や署名検索機能など、GroupDocs.Signature が提供するその他の機能を検討して、ドキュメント管理ソリューションをさらに改善することを検討してください。

FAQセクション

Q1: GroupDocs.Signature で進行状況イベントを処理する目的は何ですか? 進行状況イベントは、長時間実行される検証タスクを監視および制御するのに役立ち、特定の時間しきい値を超えた場合にタスクをキャンセルできます。

Q2: プロセスの進行状況を示すイベントハンドラーをアタッチするにはどうすればよいですか? を使って取り付けます VerifyProgress あなたのイベント Signature 実例。

Q3: ドキュメント処理のキャンセルが役立つ一般的なシナリオは何ですか? バッチ処理、ユーザーフィードバックシステム、システム効率を維持するためのリソース管理に役立ちます。

Q4: プロセスをキャンセルするための時間のしきい値を調整できますか? はい、イベントハンドラメソッド内の条件を変更します（例： args.Ticks > 350) をご要望に応じてご用意いたします。

Q5: アプリケーションで複数のドキュメントタイプを処理する必要がある場合はどうすればよいですか? GroupDocs.Signatureは様々なドキュメント形式をサポートしています。それぞれの形式に適した検証オプションを設定してください。

リソース

ドキュメント： GroupDocs.Signature ドキュメント
APIリファレンス： APIリファレンス
ダウンロード：最新リリース
ライセンスを購入： GroupDocs.Signatureライセンス