GroupDocs.Redaction for .NET を使用したドキュメントの赤字処理方法

現代のエンタープライズ環境では、ドキュメントの赤字処理方法は、個人データ、企業秘密、コンプライアンス関連情報を保護するための重要なスキルです。このガイドでは、Word、PDF、画像ファイルから機密情報を赤字処理し、赤字処理された出力をメモリストリームに直接保存する方法を、GroupDocs.Redaction for .NET を使用して説明します。

クイック回答

• 赤字処理は何を行いますか？ 選択したコンテンツをプレースホルダーに置き換えるか削除し、データが決して復元できないようにします。
• サポートされているフォーマットは？ PDF、DOCX、PPTX、一般的な画像フォーマットなど、30 以上のファイルタイプに対応しています。
• ディスクに書き込まずに赤字処理できますか？ はい、結果を MemoryStream に保存してメモリ内で処理できます。
• 本番環境でライセンスが必要ですか？ 本番利用にはフルライセンスが必要です。評価用に無料トライアルが利用可能です。
• .NET Core と互換性がありますか？ 完全に対応しています。GroupDocs.Redaction は .NET Framework 4.6 以降、.NET Core 3.1 以降、そして .NET 5/6/7 で動作します。

ドキュメントの赤字処理とは？

ドキュメントの赤字処理は、機密テキスト、画像、メタデータをファイルから永久に削除または隠蔽し、隠されたコンテンツが後で復元、閲覧、抽出できないようにします。機密要素は黒い矩形やカスタムテキストなどのプレースホルダーに置き換えられ、ドキュメント構造が更新されて赤字処理されたデータは回復不可能になります。

なぜ GroupDocs.Redaction を使ってドキュメントを赤字処理するのか？

GroupDocs.Redaction は 30 以上のファイル形式 をサポートし、ドキュメント全体をメモリに読み込むことなく 2 GB までのファイルを処理でき、競合他社に比べて 30 % 高速な処理時間を実現します。API を使用すると、単一のメソッド呼び出しで正確なフレーズ、正規表現、または画像ベースの赤字処理を適用でき、.NET 開発者にとって最も効率的な選択肢です。

前提条件

• GroupDocs.Redaction NuGet パッケージ（最新バージョン）。
• .NET Framework 4.6+ または .NET Core 3.1+ がインストールされていること。
• Visual Studio 2022 などの C# 対応 IDE。
• 基本的な C# の知識とファイル I/O の理解。

必要なライブラリとバージョン

• GroupDocs.Redaction – 常に最新リリースを使用して、最新の赤字処理アルゴリズムとセキュリティパッチにアクセスしてください。
• System.IO – ストリーム処理用（.NET に組み込み）。

ライセンス取得手順

• 無料トライアル: GroupDocs のウェブサイトで 30 日間のトライアルにサインアップしてください。
• 一時ライセンス: 開発テスト用に一時キーをリクエストしてください。
• フルライセンス: 無制限に使用できる本番ライセンスを購入してください。

基本的な初期化と設定

Redactor クラスは GroupDocs.Redaction のすべての赤字処理操作のエントリーポイントです。NuGet パッケージをインストールした後、ソースドキュメントへのパスを指定して Redactor のインスタンスを作成します。

using GroupDocs.Redaction;
using System.IO;

// Initialize Redactor with the source file path
Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/sample.docx");

ドキュメント内の特定テキストを赤字処理する方法は？

特定のテキストを赤字処理するには、Redactor インスタンスでソースファイルを読み込み、隠したい正確な文字列を対象とする ExactPhraseRedaction を適用します。API はドキュメントをスキャンし、各一致箇所を選択したオーバーレイに置き換え、変更ログに記録するため、保存前に赤字処理を検証できます。

RedactorChangeLog result = redactor.Apply(new ExactPhraseRedaction("John Doe"));

ExactPhraseRedaction クラスは、正確なフレーズのすべての出現箇所を黒い矩形（または設定した任意のカスタムプレースホルダー）に置き換えます。

ステップバイステップ:

1. ロード – ファイルを指す Redactor インスタンスを作成します。
2. 適用 – ExactPhraseRedaction（または他の赤字処理タイプ）を使って Apply を呼び出します。
3. 検査 – RedactorChangeLog を確認し、何件の一致が見つかり置き換えられたかを確認します。

赤字処理されたドキュメントをメモリストリームに保存する方法は？

MemoryStream はデータをメモリ内に保存する .NET ストリームで、ディスク I/O なしで高速な読み書きが可能です。Save メソッドを使用すると、赤字処理された出力を MemoryStream に直接書き込め、これをネットワーク経由で送信したり、データベースに保存したり、API エンドポイントから一時ファイルを作成せずに直接返すことができます。

using (MemoryStream stream = new MemoryStream())
{
    // Save the redacted document directly into the stream
    redactor.Save(stream);
    // Optionally reset the stream position for downstream consumers
    stream.Position = 0;
    // The stream now contains the redacted file ready for use
}

重要ポイント:

• Save メソッドは、MemoryStream を含む任意の Stream 実装に赤字処理された出力を書き込みます。
• 一時ファイルが作成されないため、セキュリティとパフォーマンスが向上します。
• これを ASP.NET Core の FileStreamResult と組み合わせることで、ファイルをブラウザに直接返すことができます。

よくある落とし穴と解決策

よくある質問

Q: 同じ API で PDF ファイルを赤字処理できますか？
A: はい—GroupDocs.Redaction は PDF、DOCX、PPTX、そして多くの画像フォーマットを同様に扱います。Redactor を PDF ファイルに指すだけです。

Q: ドキュメントを別の形式に変換した後でも赤字処理は保持されますか？
A: 完全に保持されます。赤字処理が行われたコンテンツは、後続の変換に関係なく永久に削除されます。

Q: 赤字処理の外観をカスタマイズするには？
A: RedactionOptions を使用してオーバーレイの色、透明度、またはテキストをカスタム文字列に置き換えることができます。

Q: 正規表現を使って赤字処理できますか？
A: はい—RegexRedaction を使用すると、クレジットカード番号やメールアドレスなどのパターンを定義できます。

Q: 公式にサポートされている .NET バージョンは？
A: .NET Framework 4.6 以上、.NET Core 3.1 以上、.NET 5、.NET 6、.NET 7。

最終更新日: 2026-07-20
テスト環境: GroupDocs.Redaction 23.12 for .NET
作者: GroupDocs

dotnet add package GroupDocs.Redaction

Install-Package GroupDocs.Redaction

string sourceFile = "YOUR_DOCUMENT_DIRECTORY/sample.docx";
using (Redactor redactor = new Redactor(sourceFile))
{
    // Continue to apply redactions...
}

関連チュートリアル

• GroupDocs.Redaction .NET を使用したドキュメントの読み込みと赤字処理：完全ガイド
• GroupDocs.Redaction .NET を使用して元の形式で赤字処理されたドキュメントを保存する方法
• .NET でストリームを使用した安全なドキュメント赤字処理：GroupDocs.Redaction ガイド