GroupDocs.Redaction for .NETでドキュメントをロードする方法

このガイドでは、ローカルディスク、メモリストリーム、さらにはパスワード保護されたファイルなど、さまざまなソースからGroupDocs.Redaction for .NETへ ドキュメントのロード方法 を学びます。レダクションサービス、 自動コンプライアンスパイプライン、またはシンプルなデスクトップユーティリティを構築する場合でも、これらのロード手法をマスターすれば、任意のドキュメントを安全にレダクションできるよう迅速かつ確実に準備できます。

クイック回答

  • 最初のステップは何ですか？ GroupDocs.Redaction NuGet パッケージをインストールし、using GroupDocs.Redaction; 名前空間を追加します。
  • ストリームからPDFをロードできますか？ はい—PDF バイトを含む MemoryStream を RedactionEngine コンストラクタに渡します。
  • パスワード保護されたファイルを開くには？ RedactionEngine を作成する際に、2 番目の引数としてパスワードを指定します。
  • ファイルサイズに制限はありますか？ GroupDocs.Redaction は、ファイル全体をメモリにロードせずに最大 2 GB のファイルを処理します。
  • 開発にライセンスは必要ですか？ テスト用の一時ライセンスで動作しますが、本番環境では正式なライセンスが必要です。

ドキュメントのロード方法は？

RedactionEngine はレダクション用にドキュメントをロードし準備するコアクラスです。ファイルパス（またはストリーム）と必要に応じてパスワードを指定して RedactionEngine インスタンスを作成することでドキュメントをロードします。このワンライナー呼び出しはファイルを読み取り、形式を検証し、レダクションの準備ができた内部ドキュメントモデルを構築します。例えば、ディスクから PDF をロードするには new RedactionEngine("sample.pdf") とするだけです。パスワードが必要な場合は new RedactionEngine("secret.pdf", "MyPassword") を使用します。ストリームからのロードも同様に MemoryStream 引数で行えます。

GroupDocs.Redaction とは何ですか？

GroupDocs.Redaction は、PDF、DOCX、PPTX、その他 30 以上のファイル形式から機密情報を検出し永久に除去できる .NET ライブラリです。ピクセル単位で正確なレダクション、OCR サポート、バッチ処理を提供し、多数のドキュメントタイプにわたって信頼性とセキュリティの高いデータ保護が求められるコンプライアンス志向のアプリケーションに最適です。

ドキュメントロードに GroupDocs.Redaction を使用する理由

GroupDocs.Redaction は、高性能で低メモリのストリーミングエンジンを提供し、最大 2 GB の大容量ファイルを処理でき、さらにパスワード保護されたドキュメントも標準でサポートします。この速度、柔軟性、セキュリティの組み合わせにより、レダクションルールを適用する前にドキュメントを迅速かつ安全にロードする必要がある開発者にとって最適な選択肢となります。

  • 幅広いフォーマットサポート: PDF、Word、Excel、PowerPoint、画像ファイルなど、30 以上 のドキュメントタイプを処理します。
  • 高性能ストリーミング: 低メモリのストリーミングエンジンを使用して 2 GB までのファイルを処理し、ファイル全体をロードする必要がなくなります。
  • パスワード処理: 単一のメソッドオーバーロードで パスワード保護された PDF と Office ファイル をシームレスに開き、コードの複雑さを削減します。
  • スレッドセーフ API: マルチスレッドサービスで複数のドキュメントを同時にロードでき、競合状態が発生しません。

前提条件

  • .NET 6.0 以降（ライブラリは .NET Core 3.1 および .NET Framework 4.6.1+ もサポート）。
  • 有効な GroupDocs.Redaction ライセンス（テスト用の一時ライセンス）。
  • レダクション対象のドキュメントファイルへのアクセス（ローカルパス、バイト配列、またはストリーム）。

様々なソースからのドキュメントロード

ローカルディスクからロード

エンジンを構築する際に、ファイルの絶対パスまたは相対パスを指定します。ライブラリは自動的にフォーマットを検出し、レダクションの準備を行います。

メモリストリームからロード

ファイルを byte[] に読み込み、MemoryStream でラップしてコンストラクタに渡します。このアプローチは、アップロードとしてファイルを受け取る Web API に最適です。

パスワード保護されたファイルをロード

ドキュメントが暗号化されている場合、2 番目の引数としてパスワードを指定します。エンジンはファイルをリアルタイムで復号し、追加の手順なしでレダクション可能なコンテンツを提供します。

よくある問題と解決策

  • エラー: “File format not supported.”
    ファイル拡張子がサポートされている形式と一致しているか、ファイルが破損していないか確認してください。GroupDocs.Redaction は 30 以上の形式をサポートしています。完全な一覧は API リファレンスをご参照ください。
  • パスワード関連の例外。
    パスワード文字列が正しいこと、ファイルが実際にパスワードを必要としていることを確認してください。保護されたファイルに空文字列を渡すと認証エラーが発生します。
  • 非常に大きなファイルでのメモリ不足。
    ファイルパスでロードする代わりにストリーミングオーバーロード（RedactionEngine(Stream)）を使用してください。これにより、数百ページの PDF でもメモリ使用量を低く抑えられます。

よくある質問

Q: DOCX ファイルも PDF と同様にロードできますか？
A: はい—ファイルパスまたはストリームを渡すだけで GroupDocs.Redaction が自動的に DOCX 形式を検出するため、追加のコードは不要です。

Q: ライブラリは Azure Blob Storage からのファイルロードをサポートしていますか？
A: もちろんです。Blob をバイト配列またはストリームとして取得し、RedactionEngine コンストラクタに渡してください。

Q: 間違ったパスワードを指定した場合はどうなりますか？
A: コンストラクタは PasswordIncorrectException をスローします。この例外を捕捉してユーザーに正しいパスワードを入力させてください。

Q: 複数のドキュメントを同時にロードできますか？
A: はい—各 RedactionEngine インスタンスは独立しておりスレッドセーフなので、バックグラウンドサービスで並列処理が可能です。

Q: RedactionEngine を手動で破棄する必要がありますか？
A: エンジンは IDisposable を実装しています。Dispose() を呼び出すか、using ブロックでラップしてファイルハンドルを速やかに解放してください。

追加リソース

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

関連チュートリアル