GroupDocs.Redaction .NET でメタデータを取得する方法

今日のデジタル時代において、ファイルから メタデータを取得する方法 は、ドキュメント中心のアプリケーションにとって基本的なステップです。コンプライアンス監査のためにファイルメタデータを読み取る必要がある場合や、インデックス作成のためにドキュメントプロパティを抽出する場合、あるいは UI にドキュメントサイズを表示したいだけの場合でも、GroupDocs.Redaction .NET は数行の C# で実行できる簡潔な API を提供します。このチュートリアルでは、環境設定から取得した情報の表示まで、プロセス全体を順を追って解説するので、すぐにドキュメントメタデータの抽出を開始できます。

クイック回答

  • メタデータを取得する主なメソッドは何ですか？ Redactor インスタンスで Redactor.GetDocumentInfo() を呼び出します。
  • サポートされているフォーマットはどれですか？ PDF、DOCX、XLSX、PPTX、画像タイプなど、50 以上の入力および出力フォーマットに対応しています。
  • 開発にライセンスは必要ですか？ テスト用には無料トライアルライセンスで動作しますが、本番環境ではフルライセンスが必要です。
  • 大きなファイルを処理できますか？ はい。GroupDocs.Redaction は、ファイル全体をメモリに読み込むことなく、数百ページに及ぶドキュメントを処理できます。
  • 非同期サポートは利用可能ですか？ API は非同期パターンでラップでき、UI スレッドの応答性を保つことができます。

GroupDocs.Redaction におけるメタデータ取得とは何ですか？

メタデータ取得とは、ライブラリの API を通じてドキュメントの組み込みプロパティ（ファイルタイプ、ページ数、サイズなど）にアクセスするプロセスです。これらのプロパティを抽出することで、開発者はプログラム上でドキュメントの特性を評価し、インデックス作成を支援し、コンプライアンス規則を適用し、今後の処理ステップについて情報に基づいた判断を行うことができます。

ドキュメントメタデータの取得方法

Redactor クラスは、GroupDocs.Redaction でドキュメントを読み込み・検査するための主要インターフェイスです。
GetDocumentInfo() は、ドキュメントのメタデータを含む DocumentInfo オブジェクトを返すメソッドです。

new Redactor("path/to/file") でファイルをロードし、GetDocumentInfo() を呼び出します。この呼び出しは、タイプ、ページ数、サイズ、その他のプロパティを含む DocumentInfo オブジェクトを返します。この 2 段階のアプローチは、サポートされているすべてのフォーマットで機能し、追加の設定は不要です。その後、FileType、PageCount、FileSize などのフィールドを読み取り、情報を表示またはログに記録できます。

前提条件

  • GroupDocs.Redaction .NET バージョン 21.6 以上。
  • .NET Framework 4.7.2 以上、.NET Core 3.1 以上、または .NET 5/6+。
  • 基本的な C# の知識と開発 IDE（Visual Studio、Rider など）。

.NET 用 GroupDocs.Redaction の設定

GroupDocs.Redaction の開始は簡単です。以下のいずれかの方法でパッケージをインストールします。

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

または、NuGet パッケージ マネージャー UI を使用します： “GroupDocs.Redaction” を検索し、Install をクリックしてください。

ライセンス取得

GroupDocs.Redaction を試すには、無料トライアルライセンスを取得できます。継続的な開発や本番環境で使用する場合は、フルライセンスを購入するか、公式サイトから一時ライセンスをリクエストしてください。

インストールが完了したら、以下のようにライブラリを初期化します：

using GroupDocs.Redaction;

実装ガイド

ドキュメント情報取得機能

この機能は、GroupDocs.Redaction .NET を使用してドキュメントから重要なメタデータを抽出することに焦点を当てています。以下の手順に従ってください：

手順 1: ドキュメントパスの準備

対象ファイルへの絶対パスまたは相対パスを定義します：

string sourceFile = "YOUR_DOCUMENT_DIRECTORY\\SampleDocx.docx";

YOUR_DOCUMENT_DIRECTORY を、ドキュメントが格納されているフォルダーに置き換えてください。

手順 2: Redactor インスタンスの初期化

メタデータメソッドにアクセスできる Redactor オブジェクトを作成します：

using (Redactor redactor = new Redactor(sourceFile))
{
    // Further operations will be performed here
}

手順 3: ドキュメント情報の取得

Redactor インスタンスで GetDocumentInfo() を呼び出し、利用可能なすべてのプロパティを取得します：

IDocumentInfo info = redactor.GetDocumentInfo();

返されるオブジェクトには、ファイルタイプ、ページ数、ファイルサイズが含まれます。

手順 4: ドキュメント詳細の表示

情報をコンソールまたは UI に出力します。サンプルコード（単体実行用にコメント化されています）は、各プロパティの出力方法を示しています：

Console.WriteLine($"File type: {info.FileType}\\
Number of pages: {info.PageCount}\\
Document size: {info.SizeInBytes} bytes");

なぜ GroupDocs.Redaction をメタデータ抽出に使用するのか？

GroupDocs.Redaction は 50 以上のファイル形式 をサポートし、サイズが 2 GB までのドキュメントを処理でき、典型的なワークロードではメモリ使用量を 100 MB 未満に抑えます。ライブラリはドキュメント全体をロードせずにメタデータを抽出し、迅速な応答を提供します—標準的なサーバーハードウェア上の 100 ページ PDF でも 200 ms 未満で処理できることが多いです。

よくある問題と解決策

  • ファイルパスが正しくない – パス文字列を確認し、実行プロセスがファイルにアクセスできることを確認してください。
  • サポートされていない形式 – フォーマット一覧を確認し、欠けている形式がある場合は、先に変換することを検討してください。
  • パフォーマンスのボトルネック – 非常に大きなファイルの場合、ストリーミングオプションを有効にするか、ページをバッチ処理してメモリ使用量を制限してください。

実用的な活用例

ドキュメントのメタデータを理解することで、以下のような実際のシナリオが可能になります：

  1. Document Management Systems (DMS) – タイプ、サイズ、ページ数に基づいてカテゴリ分けとインデックス作成を自動化します。
  2. Compliance Auditing – 機密ファイルがアーカイブ前に必要なメタデータを含んでいるか検証します。
  3. Data Migration – プロパティでファイルをグループ化し、バルクマイグレーション作業を効率化します。

パフォーマンス上の考慮点

  • 効率的なリソース使用 – Redactor インスタンスを using ブロック内で使用し、適切に破棄されることを保証します。
  • 非同期パターン – メタデータ呼び出しを Task.Run でラップするか、非同期ラッパーを実装して、デスクトップや Web アプリで UI スレッドの応答性を保ちます。

よくある質問

Q: どのドキュメント形式からメタデータを抽出できますか？
A: GroupDocs.Redaction は PDF、DOCX、XLSX、PPTX、HTML、一般的な画像タイプなど、50 以上の形式からメタデータを読み取ります。

Q: パスワードで保護されたファイルはどう処理しますか？
A: パスワードを Redactor コンストラクタに渡すと、API がファイルを復号化してからメタデータを抽出します。

Q: 処理できるファイルサイズに制限はありますか？
A: 明確な上限はありませんが、2 GB を超えるファイルは追加のメモリ調整が必要になる場合があります。パフォーマンスはファイルサイズに対して線形に保たれます。

Q: バッチ操作でメタデータを取得できますか？
A: はい。ファイルパスのコレクションを反復し、各パスで GetDocumentInfo() を呼び出します。ライブラリは並列実行に対してスレッドセーフです。

Q: 開発ビルドにライセンスは必要ですか？
A: 開発およびテストには無料トライアルライセンスで十分です。商用環境でのデプロイには商用ライセンスが必要です。

リソース

結論

これで、GroupDocs.Redaction .NET を使用した メタデータ取得方法 に関する完全なステップバイステップガイドが手に入りました。Redactor.GetDocumentInfo() メソッドを活用すれば、ファイルメタデータを迅速に読み取り、コンプライアンスワークフローを支援し、あらゆるドキュメント処理パイプラインを強化できます。コンテンツのレダクション、透かし、ドキュメント変換など、Redaction の他の機能も探求して、フル機能のドキュメント管理ソリューションを構築してください。

最終更新日: 2026-06-06
テスト環境: GroupDocs.Redaction .NET 21.6（執筆時点での最新）
作者: GroupDocs

関連チュートリアル