GroupDocs.Signature for .NET によるマスター ドキュメントの署名と検証

GroupDocs.Signature for .NET でドキュメントの署名と検証をマスターする方法

今日のデジタル環境において、契約書、合意書、その他あらゆる法的文書の管理には、効率的な文書署名ソリューションが不可欠です。このプロセスを自動化することで、時間を節約し、エラーを削減できます。 .NET 用 GroupDocs.Signature アプリケーションにおけるテキスト署名管理を効率化する堅牢なソリューションを提供します。この包括的なガイドでは、テキスト署名の署名、検証、検索、更新、削除など、GroupDocs.Signature for .NETの機能について詳しく説明します。

学ぶ内容

  • カスタマイズ可能なテキスト署名で文書に署名する方法
  • 署名された文書を効果的に検証する技術
  • 文書内の既存のテキスト署名を検索する方法
  • 必要に応じてテキスト署名を更新および削除する手順
  • パフォーマンスとメモリ管理を最適化するためのベストプラクティス

まず前提条件を確認しましょう。

前提条件

始める前に、開発環境に必要なツールがセットアップされていることを確認してください。

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

  • .NET 用 GroupDocs.Signature: このライブラリを使用すると、アプリケーションに署名機能を追加できます。
  • .NET Framework 4.6.1 以上 (または .NET Core 2.x+)

環境設定要件

必要なパッケージをダウンロードするには、Visual Studio などの C# 開発環境とインターネット接続が必要です。

知識の前提条件

C#プログラミングの基本的な概念を理解していることが推奨されます。GroupDocs.Signature for .NETを初めてお使いになる方もご安心ください。このガイドですべての手順を丁寧にご説明いたします。

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

まず、プロジェクトにGroupDocs.Signatureライブラリをインストールする必要があります。手順は以下のとおりです。

.NET CLI 経由のインストール

dotnet add package GroupDocs.Signature

パッケージマネージャーコンソール

Install-Package GroupDocs.Signature

NuGet パッケージ マネージャー UI

  1. Visual Studio でプロジェクトを開きます。
  2. 移動先 ツール > NuGet パッケージ マネージャー > ソリューションの NuGet パッケージを管理する。
  3. 「GroupDocs.Signature」を検索し、最新バージョンをインストールしてください。

ライセンス取得手順

基本的な初期化とセットアップ

インストール後、プロジェクト内の GroupDocs.Signature を次のように初期化します。

using GroupDocs.Signature;

// ドキュメント パスを使用して Signature インスタンスを初期化します。
Signature signature = new Signature("path/to/your/document.pdf");

セットアップが完了したら、GroupDocs.Signature をさまざまな機能に活用する方法を検討してみましょう。

実装ガイド

テキスト署名で文書に署名する

この機能を使うと、文書にテキスト署名を追加できます。詳しく見ていきましょう。

概要

フォント サイズ、色、配置などのさまざまなオプションを使用して、テキスト署名の外観と位置をカスタマイズできます。

ステップバイステップの実装

ステップ1: ファイル パスと出力場所を定義します。

string filePath = "YOUR_DOCUMENT_DIRECTORY"; // 元の文書へのパス
string outputFilePath = Path.Combine("YOUR_OUTPUT_DIRECTORY", "SignedDocument.docx");

ステップ2: テキスト署名を作成する TextSignOptions。

using (Signature signature = new Signature(filePath))
{
    TextSignOptions signOptions = new TextSignOptions("John Smith")
    {
        VerticalAlignment = GroupDocs.Signature.Options.VerticalAlignment.Top,
        HorizontalAlignment = GroupDocs.Signature.Options.HorizontalAlignment.Center,
        Width = 100,
        Height = 40,
        Margin = new Padding(20),
        ForeColor = Color.Red,
        Font = new SignatureFont { Size = 12, FamilyName = "Comic Sans MS" }
    };

ステップ3: 文書に署名し、結果を出力します。

    SignResult signResult = signature.Sign(outputFilePath, signOptions);
    foreach (BaseSignature temp in signResult.Succeeded)
    {
        Console.WriteLine($"Signed Text Signature: Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}

主要な設定オプション

  • 垂直配置と水平配置ページ上で署名が表示される場所を制御します。
  • フォントテキスト署名のフォント サイズとスタイルをカスタマイズします。

文書のテキスト署名を検証する

検証は、文書が意図したとおりに署名されていることを確認するものです。実装方法は次のとおりです。

概要

ドキュメント内の既存のテキスト署名を検証して、その信頼性と整合性を確認します。

ステップバイステップの実装

ステップ1: 署名された文書のファイル パスを指定します。

string filePath = "YOUR_OUTPUT_DIRECTORY"; // 署名済み文書へのパス

ステップ2: 検証オプションを作成する TextVerifyOptions。

using (Signature signature = new Signature(filePath))
{
    TextVerifyOptions verifyOptions = new TextVerifyOptions()
    {
        AllPages = false,
        PageNumber = 1,
        Text = "John Smith",
        MatchType = GroupDocs.Signature.Options.TextMatchType.Exact
    };

ステップ3: ドキュメントを確認します。

    VerificationResult verifyResult = signature.Verify(verifyOptions);
    if (verifyResult.IsValid)
    {
        Console.WriteLine("Document was verified successfully!");
    }
    else
    {
        Console.WriteLine("Document failed verification process.");
    }
}

トラブルシューティングのヒント

  • 確実に Text プロパティはドキュメントの内容と完全に一致します。
  • 確認する PageNumber 署名が含まれる正しいページに対応します。

テキスト署名のドキュメント検索

この機能を使用すると、ドキュメント内のテキスト署名を効率的に見つけることができます。

概要

ドキュメントの全ページまたは選択したページを検索して、特定のテキスト署名を見つけます。

ステップバイステップの実装

ステップ1: ファイルパスを定義します。

string filePath = "YOUR_OUTPUT_DIRECTORY"; // 署名済み文書へのパス

ステップ2： 使用 TextSearchOptions 検索用です。

using (Signature signature = new Signature(filePath))
{
    TextSearchOptions searchOptions = new TextSearchOptions()
    {
        AllPages = true,
        MatchType = GroupDocs.Signature.Options.TextMatchType.Exact,
        Text = "John Smith"
    };

ステップ3: 検索を実行します。

    List<TextSignature> signatures = signature.Search<TextSignature>(searchOptions);
    foreach (TextSignature textSignature in signatures)
    {
        if (textSignature != null)
        {
            Console.WriteLine($"Found Text signature at page {textSignature.PageNumber} with type [{textSignature.SignatureImplementation}] and text '{textSignature.Text}'. Location: {textSignature.Left}-{textSignature.Top}. Size is {textSignature.Width}x{textSignature.Height}.");
        }
    }
}

ドキュメントのテキスト署名を更新する

必要に応じて、ドキュメント内の既存のテキスト署名を変更します。

概要

既存のテキスト署名のサイズや位置などのプロパティを調整します。

ステップバイステップの実装

ステップ1: ファイル パスと署名 ID を指定します。

string filePath = "YOUR_OUTPUT_DIRECTORY"; // 署名済み文書へのパス
List<string> signatureIds = new List<string>(); // このリストには有効な署名IDが入力されていると仮定します

ステップ2： 作成する TextSignature 更新用のオブジェクト。

using (Signature signature = new Signature(filePath))
{
    foreach (var item in signatureIds)
    {
        TextSignature temp = new TextSignature(item)
        {
            Width = 150,
            Height = 50,
            HorizontalAlignment = GroupDocs.Signature.Options.HorizontalAlignment.Right
        };

ステップ3: ドキュメントを更新します。

        SignResult signResult = signature.UpdateSignatures(temp);
        if (signResult.Succeeded.Count > 0)
        {
            Console.WriteLine($"Updated Text Signature: Id:{temp.SignatureId}");
        }
    }
}

主要な設定オプション

  • 幅と高さ署名のサイズを調整します。
  • 水平配置更新された署名がページ上のどこに表示されるかを制御します。

結論

このガイドでは、GroupDocs.Signature for .NETを使用して、ドキュメント内のテキスト署名に署名、検証、検索、更新、削除する方法を学習しました。これらの機能は、アプリケーションにおけるデジタル署名プロセスの自動化に不可欠です。より詳細な情報と高度なオプションについては、 公式文書.