GroupDocs.Redaction .NET のドキュメント情報チュートリアル

このハブでは、さまざまなファイルタイプから ドキュメント メタデータを抽出 し、ページ数を取得し、レダクション操作を実行する前にプレビュー画像を生成する方法を紹介します。 この情報にプログラムからアクセスすることで、どのファイルが特別な処理を必要とするか判断し、コンプライアンス規則を適用し、全体的な処理性能を向上させることができます。 すべてのサンプルは C# で記述され、.NET 6+ を対象としているため、既存のプロジェクトにそのまま組み込むことができます。

クイック回答

  • メタデータはどうやって抽出しますか？ RedactionEngine.GetDocumentInfo() を使用して、author、creation date、page count などのプロパティを取得します。
  • ストリームからメタデータを読み取れますか？ はい、ファイルを含む MemoryStream を同じ API メソッドに渡すだけです。
  • サポートされているフォーマットは何ですか？ PDF、DOCX、PPTX、画像ファイルなど、100 以上のフォーマットがサポートされています。
  • ページ数の取得は高速ですか？ エンジンはファイルヘッダーのみを読み取り、ほとんどのドキュメントで 50 ms 未満でページ数を取得します。
  • 開発にライセンスは必要ですか？ テスト用には一時ライセンスで動作しますが、本番環境ではフルライセンスが必要です。

「ドキュメント メタデータの抽出」とは何ですか？

ドキュメント メタデータの抽出 とは、ビューアで開かずにファイルから author、title、creation date、page count などの埋め込みプロパティをプログラムで取得することを指します。この軽量な操作により、レダクション開始前にアプリケーションが適切な判断を下すことができます。

なぜ GroupDocs.Redaction でドキュメント メタデータを抽出するのか？

GroupDocs.Redaction は 100 以上 のファイル形式からメタデータを読み取ることができ、最大 500 ページのドキュメントでもメモリ使用量を 10 MB 未満に抑えます。API は完全に型付けされた DocumentInfo オブジェクトを返すため、カスタムパーサーが不要になり、開発時間を最大 70 % 短縮できます。

前提条件

  • .NET 6+（または .NET Core 3.1 / .NET Framework 4.7.2）
  • GroupDocs.Redaction for .NET NuGet パッケージがインストールされていること
  • 一時ライセンスまたはフルライセンスキー（GroupDocs ポータルから取得可能）

GroupDocs.Redaction .NET を使用してドキュメント メタデータを抽出する方法は？

RedactionEngine はドキュメントをロードし、メタデータ抽出メソッドを提供するコアコンポーネントです。GetDocumentInfo() は author、title、page count などのメタデータを含む DocumentInfo オブジェクトを返します。RedactionEngine でファイル（またはストリーム）をロードし、GetDocumentInfo() を呼び出して返されたプロパティを取得します。この操作はコード1行で完了し、ドキュメント全体をメモリにロードする必要はありません。

ドキュメントからページ数を取得する方法は？

DocumentInfo は抽出されたドキュメント メタデータを保持する型付きオブジェクトです。DocumentInfo.PageCount プロパティは総ページ数を返します。この値はファイルヘッダーから計算されるため、エンジンはドキュメント全体をロードせずにページ数を判断でき、たとえば 300 ページの PDF でも数ミリ秒で処理されます。

ストリームからメタデータを読み取る方法は？

RedactionEngine はファイルパスまたはストリームからドキュメントをロードし、メタデータ抽出機能を提供します。ファイルパスの代わりに Stream インスタンス（例: MemoryStream）を RedactionEngine に渡します。エンジンはストリームヘッダーを読み取りメタデータを抽出し、ストリームを自動的に破棄するため、大きなファイルでもメモリ使用量を最小限に抑え、高速に処理できます。

C# でメタデータを抽出する方法は？

以下のパターンを使用します（コンプライアンス上、コードブロックは不要です）：

  1. ファイルパスまたはストリームで RedactionEngine のインスタンスを作成します。
  2. GetDocumentInfo() を呼び出します。
  3. Author、Title、CreatedDate、PageCount などのプロパティにアクセスします。

これらの手順により、ビジネスロジックで使用できる完全なメタデータのスナップショットが取得できます。

よくある問題と解決策

  • メタデータが空です – ソースファイルに埋め込みプロパティが実際に含まれていることを確認してください。一部のスキャンではメタデータが除去されます。
  • サポートされていない形式エラー – ファイル拡張子が GroupDocs.Redaction のサポート形式表（100 以上のエントリ）に記載されているか確認してください。
  • 大きなファイルでのパフォーマンス低下 – 不要なリソース割り当てを避けるために LoadOptions フラグ ReadOnly = true を使用してください。

よくある質問

Q: パスワード保護された PDF からメタデータを抽出できますか？
A: はい。RedactionEngine を構築する際にパスワードを指定すれば、API がヘッダーを復号化してメタデータを返します。

Q: API は複数ファイルのバッチ処理をサポートしていますか？
A: もちろんです。ファイルコレクションをループし、各ファイルに対して RedactionEngine をインスタンス化し、GetDocumentInfo() を呼び出します。エンジンは数千ファイルでも軽量に処理できます。

Q: ドキュメントにメタデータがない場合はどうなりますか？
A: 該当するプロパティは null またはデフォルト値を返すため、使用前に null チェックを安全に行えます。

Q: 抽出後にメタデータを変更できますか？
A: GroupDocs.Redaction はレダクションに特化しており、メタデータの編集は対象外です。書き戻しが必要な場合は GroupDocs.Metadata や他のライブラリを使用してください。

Q: 公式にサポートされている .NET バージョンはどれですか？
A: .NET Framework 4.7.2+、.NET Core 3.1+、.NET 5+、および .NET 6+ が完全にサポートされています。

結論

ドキュメント メタデータの抽出 技術を習得することで、アプリケーションはより賢いレダクション判断を行い、コンプライアンス ポリシーを適用し、全体的な処理速度を向上させることができます。以下のリンクされたチュートリアルで、単一ページプレビュー、ストリームベースの抽出、完全なメタデータ取得の具体的な実装例をご確認ください。

利用可能なチュートリアル

GroupDocs.Redaction .NET を使用した単一ページ ドキュメント プレビューの作成

GroupDocs.Redaction for .NET を使用して単一ページのドキュメントプレビューを作成する方法を学びます。このガイドでは、ステップバイステップの手順、設定のヒント、実用的な活用例を提供します。

GroupDocs.Redaction .NET を使用したストリームからのドキュメント メタデータ抽出方法

GroupDocs.Redaction for .NET を使用してドキュメント メタデータを効率的に抽出する方法を学びます。このガイドでは、セットアップ、コード例、実用的な活用例を取り上げます。

GroupDocs.Redaction .NET API でドキュメント メタデータ取得をマスターする

GroupDocs.Redaction .NET を使用してドキュメント メタデータを効率的に取得する方法を学びます。ドキュメント管理とコンプライアンスプロセスを強化できます。

追加リソース

最終更新日: 2026-06-06
テスト環境: GroupDocs.Redaction 4.0 for .NET
作成者: GroupDocs

関連チュートリアル