GroupDocs.Signature for .NET でドキュメント情報を取得する方法

導入

契約書や署名済みの文書を扱う際には、文書の整合性を管理・検証することが非常に重要です。このチュートリアルでは、以下のツールを使って文書から重要な情報を抽出する方法を説明します。 .NET 用 GroupDocs.Signatureこのライブラリを活用することで、開発者はアプリケーション内でデジタル署名を管理するプロセスを自動化できます。

このガイドでは、次の内容を学習します。

GroupDocs.Signature for .NET の設定方法
フォーマット、サイズ、ページ数などの基本的なドキュメントプロパティの取得
文書内のさまざまな署名の種類を数える
各ページの詳細情報の抽出

実装に進む前に、前提条件を確認しましょう。

前提条件

必要なライブラリ、バージョン、依存関係

このチュートリアルを実行するには、次のものが必要です。

.NET Core 3.1 またはそれ以降のバージョンがマシンにインストールされています。
その .NET 用 GroupDocs.Signature 図書館。

環境設定要件

開発環境が、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」を検索し、IDE から直接最新バージョンをインストールします。

ライセンス取得手順

無料トライアルまずは無料トライアルをダウンロードしてくださいグループドキュメントこれにより、初期投資なしでライブラリの機能を探索できます。
一時ライセンス評価にさらに時間が必要な場合は、一時ライセンスの申請を検討してください。このリンク.
購入商用利用の場合は、ライセンスを購入してください。 GroupDocs 購入ページ.

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

インストールしたら、 Signature オブジェクトにドキュメントのパスを設定します。これは、GroupDocs.Signature のさまざまな機能にアクセスするために不可欠です。

実装ガイド

このセクションでは、GroupDocs.Signature for .NET を使用してドキュメントに関する基本情報を取得する手順について説明します。

ドキュメント情報を取得

概要

署名された文書の構造と内容を理解するには、ファイルの種類、サイズ、ページ数などのメタデータを抽出します。このプロセスは、これらの属性に基づいて文書を検証またはインデックス付けする必要があるアプリケーションにとって不可欠です。

using System;
using GroupDocs.Signature;
using GroupDocs.Signature.Domain;

string filePath = "YOUR_DOCUMENT_DIRECTORY\SampleSignedMulti";

// ドキュメントパスで署名オブジェクトを初期化します
to (Signature signature = new Signature(filePath))
{
    // GetDocumentInfoメソッドを使用してドキュメント情報を取得します
    IDocumentInfo documentInfo = signature.GetDocumentInfo();
    
    // ドキュメントの基本プロパティを出力する
    Console.WriteLine($"- format : {documentInfo.FileType.FileFormat}");
    Console.WriteLine($"- extension : {documentInfo.FileType.Extension}");
    Console.WriteLine($"- size : {documentInfo.Size}");
    Console.WriteLine($"- page count : {documentInfo.PageCount}");

    // さまざまな署名タイプの出力数
    Console.WriteLine($"- Form Fields count : {documentInfo.FormFields.Count}");
    Console.WriteLine($"- Text signatures count : {documentInfo.TextSignatures.Count}");
    Console.WriteLine($"- Image signatures count : {documentInfo.ImageSignatures.Count}");
    Console.WriteLine($"- Digital signatures count : {documentInfo.DigitalSignatures.Count}");
    Console.WriteLine($"- Barcode signatures count : {documentInfo.BarcodeSignatures.Count}");
    Console.WriteLine($"- QrCode signatures count : {documentInfo.QrCodeSignatures.Count}");
    Console.WriteLine($"- FormField signatures count : {documentInfo.FormFieldSignatures.Count}");

    // 各ページの幅や高さなどのページ詳細を出力する
    foreach (PageInfo pageInfo in documentInfo.Pages)
    {
        Console.WriteLine($"- page-{pageInfo.PageNumber} Width {pageInfo.Width}, Height {pageInfo.Height}");
    }
}

説明

署名オブジェクトの初期化まず、 Signature ドキュメントへのパスを持つクラス。このオブジェクトは、ドキュメント関連のさまざまな機能にアクセスするためのゲートウェイとして機能します。
GetDocumentInfo メソッドこのメソッドを呼び出すと、ドキュメントに関する豊富なメタデータセットが取得されます。これには、基本的なプロパティだけでなく、ドキュメント内に存在する署名に関する詳細情報も含まれます。
ドキュメントプロパティの出力取得された IDocumentInfo オブジェクトは、ファイル形式、拡張子、サイズ、ページ数など、様々な詳細情報へのアクセスを提供します。これは、ドキュメントの特性に基づいてログ記録や処理を行う際に役立ちます。
署名カウンター文書に含まれる署名の種類の数を把握することは、検証プロセスにおいて非常に重要です。各種類（テキスト、画像、デジタルなど）にはそれぞれ特定の目的があり、その数を把握することで完全性を検証するのに役立ちます。
ページ情報各ページのサイズにアクセスすることで、アプリケーションはレイアウトを調整したり、ページサイズに依存する操作を実行したりできるようになります。

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

ドキュメントパスが正しく指定されていることを確認してください。そうでない場合、例外がスローされる可能性があります。
ファイルの読み取りに必要なすべての権限が環境に設定されていることを確認します。
署名数に関する問題が発生した場合は、使用しているドキュメント形式に署名が正しく埋め込まれていることを確認してください。

実用的な応用

文書管理システムメタデータに基づいてドキュメントの整理と検索を自動化します。
法律ソフトウェア処理前に必要なすべてのデジタル署名をチェックして契約を検証します。
アーカイブソリューションページサイズ情報を使用して、保存形式またはレイアウトを最適化します。
コンテンツ検証ツール必要なすべての署名タイプがドキュメント内に存在することを確認するシステムを実装します。
CRMシステムとの統合検証されインデックスが付けられた署名済みドキュメントで顧客レコードを強化します。

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

GroupDocs.Signature を使用する際に最適なパフォーマンスを維持するには、次のベストプラクティスを考慮してください。

非同期処理可能な場合は、メインスレッドがブロックされないように、I/O 操作を非同期的に処理します。
リソース管理：処分する Signature 使用後はオブジェクトを適切に破棄してリソースを解放します。
バッチ処理複数のドキュメントを処理する場合は、オーバーヘッドを削減するために、ドキュメントを 1 つずつ処理するのではなく、バッチで処理します。

結論

このチュートリアルでは、GroupDocs.Signature for .NET を使用して基本的なドキュメント情報を取得する方法を学習しました。この機能は、署名済みドキュメントの詳細な情報を必要とするアプリケーションにとって非常に役立ち、管理と検証プロセスの改善に役立ちます。GroupDocs.Signature の機能をさらに詳しく知るには、署名の追加や検証などの追加機能を試してみることを検討してください。

このソリューションをプロジェクトに導入する準備はできていますか？今すぐ試して、ドキュメント処理ワークフローを強化しましょう。

FAQセクション

1. GroupDocs.Signature for .NET は何に使用されますか? GroupDocs.Signature for .NET は、署名されたドキュメントへの情報の追加、検証、抽出などの機能を提供し、デジタル署名の管理を容易にする包括的なライブラリです。