.NET で Word の画像を赤字処理するための GroupDocs の使用方法
Microsoft Word ファイル内の機密画像を保護する必要があるとき、GroupDocs の使い方 が最初の課題になります。このチュートリアルでは、埋め込まれた画像を見つけ、マスクし、永久に削除するために必要なすべての手順を順を追って説明します。
クイック回答
- GroupDocs はすべての画像を自動的に赤字処理できますか? はい、各画像を反復処理し
ImageAreaRedactionを適用できます。 - サポートされている .NET バージョンはどれですか? .NET Framework 4.5+、.NET Core 3.1+、.NET 5/6/7。
- 開発にライセンスは必要ですか? 無料トライアルでテストは可能ですが、本番環境では永続ライセンスが必要です。
- 元のレイアウトは保持されますか? API は画像領域を空白にするだけで、テキストと書式設定はそのまま保持します。
- 処理速度はどれくらいですか? GroupDocs.Redaction は、一般的なサーバー上で 200 ページのドキュメントを 2 秒未満で処理できます。
GroupDocs.Redaction とは?
GroupDocs.Redaction は、テキスト、画像、メタデータをプログラムで赤字処理できる .NET ライブラリで、20 以上のドキュメント形式に対応しています。Microsoft Office をインストールせずにファイルを処理できるため、サーバー側の自動化に最適です。テキスト、画像、メタデータの赤字処理用 API を提供し、バッチ処理、カスタム赤字パターン、コンプライアンスレポートにも対応しています。
Word で画像の赤字処理に GroupDocs を使用する理由
このライブラリは 20 以上の入力・出力形式 をサポートし、最大 500 MB のドキュメントでも全体をメモリに読み込まずに画像を赤字処理できます。組み込みの ImageAreaRedaction アルゴリズムは、赤字処理された領域が復元できないことを保証し、厳格なコンプライアンス基準を満たします。
前提条件
- .NET Framework 4.5+ または .NET Core 3.1+ がインストールされていること。
- 基本的な C# の知識と Word ファイル構造への理解。
- GroupDocs.Redaction NuGet パッケージへのアクセス(無料トライアルまたはライセンス版)。
.NET 用 GroupDocs.Redaction のセットアップ方法
.NET CLI で GroupDocs.Redaction をインストールする方法
プロジェクトフォルダーで次のコマンドを実行します: dotnet add package GroupDocs.Redaction。これにより、最新の安定版がプロジェクトファイルに追加されます。
dotnet add package GroupDocs.Redaction
パッケージマネージャーを使用して GroupDocs.Redaction をインストールする方法
Package Manager Console で Install-Package GroupDocs.Redaction を実行します。
Install-Package GroupDocs.Redaction
一時ライセンスの取得と適用方法
一時ライセンスは Temporary License ページからリクエストできます。
一時ライセンスを使用すると、透かしなしでフル機能を評価できます。購入後、ライセンスファイルをプロジェクトに配置し、以下のようにロードします:
using GroupDocs.Redaction;
Word ドキュメント内の埋め込み画像を赤字処理する方法
画像を赤字処理するには、Redactor インスタンスでドキュメントを読み込み、各画像を検索し、隠す領域を定義して ImageAreaRedaction を適用します。API は選択されたピクセルを上書きし、元のビジュアルコンテンツが復元できないようにすると同時に、周囲のレイアウトとテキストを保持します。
ソースと出力パスの準備方法
オブジェクトを作成する前に、元のドキュメントと赤字処理後の結果の絶対パスを定義します。
string sourceFile = "YOUR_DOCUMENT_DIRECTORY/LOREMIPSUM_PDF";
string outputFile = "YOUR_OUTPUT_DIRECTORY/redacted_output.docx";
Redactor オブジェクトの作成と構成方法
Redactor はドキュメントを読み込み、赤字処理操作を実行するコアクラスです。Redactor のインスタンスをドキュメントで作成します:
using (Redactor redactor = new Redactor(sourceFile))
{
// Code for redaction will go here
}
座標の指定と画像領域赤字処理の適用方法
ImageAreaRedaction は画像の矩形領域を単色でマスクするメソッドです。
隠したい領域の左上点 (samplePoint) とサイズ (sampleSize) を特定し、ImageAreaRedaction を呼び出します。このメソッドは選択されたピクセルを単色で上書きします。
Point samplePoint = new Point(516, 311);
Size sampleSize = new Size(170, 35);
RedactorChangeLog result = redactor.Apply(new ImageAreaRedaction(
samplePoint,
new RegionReplacementOptions(Color.Blue, sampleSize)
));
赤字処理結果の検証とファイル保存方法
Redactor.Apply() を呼び出した後、Result オブジェクトを確認します。IsSuccess が true の場合、変更されたドキュメントを出力パスに書き込みます。
if (result.Status != RedactionStatus.Failed)
{
var savedOutputFile = redactor.Save();
Console.WriteLine($"Redacted document saved as: {savedOutputFile}");
}
よくある問題とトラブルシューティングのヒント
- 座標エラー: X/Y の値が画像の境界内にあることを確認してください。範囲外の場合、API は
ArgumentOutOfRangeExceptionをスローします。 - ライセンスがない: トライアルライセンスは 30 日で期限切れになるため、実行時エラーを防ぐために永続ライセンスに置き換えてください。
- サポート外の形式: ファイル拡張子がドキュメントに記載された 20 以上の形式のいずれかであることを確認してください。古い
.docファイルはまず.docxに変換する必要があります。
実用的な活用例
- 機密レポート: 外部配布前にロゴやチャートを赤字処理します。
- 法的ブリーフ: 個人情報を含むクライアントの写真やスキャンした ID を隠します。
- ビジネス契約: 企業秘密を示す独自の図面をマスクします。
- 政府公開資料: Word から生成された公開 PDF から機密衛星画像を除去します。
パフォーマンスに関する考慮点
- 大量バッチ処理時は、メモリ使用量を抑えるためにドキュメントを順次処理します。
- 制約のあるサーバーで実行する場合、
RedactorOptionsを使用してスレッド数を制限します。 usingを使ってRedactorインスタンスを速やかに破棄し、アンマネージドリソースを解放します。
結論
これで、GroupDocs の使い方 を理解し、.NET API を使用して Word ファイル内の埋め込み画像を確実に赤字処理できるようになりました。上記の手順に従えば、この機能を任意のドキュメント処理パイプラインに組み込むことができ、機密画像が組織外に漏れ出すことを防げます。
さらに深く探求するには、テキストやメタデータなど他の赤字処理タイプを試し、ライブラリを Web サービス、バックグラウンドワーカー、または Azure Functions に統合してください。
よくある質問
Q: 1 回の処理で複数の画像を赤字処理できますか?
A: はい、各画像ノードを反復処理し、隠す必要がある領域ごとに ImageAreaRedaction を呼び出します。
Q: GroupDocs.Redaction はパスワード保護された Word ファイルをサポートしていますか?
A: もちろんです。Redactor オブジェクトを作成する際にパスワードを指定すれば、ライブラリは安全にドキュメントを開きます。
Q: DOCX 以外に処理できるファイル形式は何ですか?
A: API は DOC、DOCX、RTF、HTML、PDF、その他 20 以上の形式に対応しており、汎用的な赤字処理サービスを構築できます。
Q: ライセンスなしで赤字処理をテストするには?
A: GroupDocs ポータルから一時ライセンスを取得してください。透かしなしで 30 日間フル機能が利用できます。
Q: 問題が発生した場合、どこでサポートを受けられますか?
A: コミュニティ支援は GroupDocs Free Support フォーラムをご覧いただくか、エンタープライズサポートは GroupDocs の営業にお問い合わせください。
追加リソース
- ドキュメント: GroupDocs Redaction Documentation
- API リファレンス: GroupDocs API Reference
- ダウンロード: Latest Releases
最終更新日: 2026-10-16
テスト環境: .NET 用 GroupDocs.Redaction 23.12
作者: GroupDocs