GroupDocs.Redaction .NET (C#) でデータを編集(赤字)する方法
この包括的なチュートリアルでは、GroupDocs.Redaction for .NET を使用して PDF、Word ファイル、その他のドキュメントから データを編集(赤字)する方法 を学びます。法的契約書の個人識別子を隠す必要がある場合や、財務報告書から機密数値を削除したい場合でも、SDK はプログラムから制御でき、すべての機密要素を永続的かつ監査可能に削除します。ライブラリのインストール、カスタム IRedactionCallback の設定、完全なロギング付きで正確なフレーズの編集(赤字)を適用する手順を順に解説します。
クイック回答
- IRedactionCallback は何をするものですか? すべての編集(赤字)イベントをインターセプトし、詳細をログに記録し、必要に応じて置換テキストをリアルタイムで変更できます。
- ライセンスは必要ですか? 開発用にはトライアルで動作します。永続ライセンスを取得すれば評価制限がすべて解除されます。
- 対応している .NET バージョンは? .NET Core 3.1+、.NET 5/6、.NET Framework 4.6+ をサポートしています。
- 複数ファイルを処理できますか? はい。ロジックをループでラップするか、バッチ処理を使用すれば最適なパフォーマンスが得られます。
- 非同期編集(赤字)は可能ですか? 組み込みの非同期機能はありませんが、
Task.Runなどの非同期パターンで API 呼び出しを実行できます。
敏感データの編集(赤字)とは?
Redaction は、開示してはならない情報を永久に削除または隠蔽することです。GroupDocs.Redaction では、正確なフレーズ、正規表現パターン、またはカスタムルールを定義し、[REDACTED] などのプレースホルダーに置き換えて、元のレイアウトやページ番号を保持します。
IRedactionCallback と共に GroupDocs.Redaction を使用する理由
IRedactionCallback は、SDK がコンテンツを編集(赤字)するたびに通知を受け取るインターフェイスで、監査データの取得や置換テキストの動的調整が可能です。これにより、完全な監査性、カスタムビジネスルールの適用、コンプライアンスシステムとのシームレスな統合が実現し、パフォーマンスを犠牲にしません。
前提条件
- GroupDocs.Redaction ライブラリ(対応バージョン – 公式の documentation page を参照)。詳細は official documentation をご覧ください。
- 開発マシンに .NET Core または .NET Framework がインストールされていること。
- Visual Studio(Community エディションで可)または C# をサポートする任意の IDE。
- 基本的な C# の知識と NuGet パッケージ管理に慣れていること。
GroupDocs.Redaction for .NET の設定
まず、ライブラリをプロジェクトに追加します。CLI、Package Manager Console、または UI のいずれか好きな方法を選んでください。コマンドは元のチュートリアルと全く同じです。
インストールオプション
.NET CLI:
dotnet add package GroupDocs.Redaction
Package Manager Console:
Install-Package GroupDocs.Redaction
NuGet Package Manager UI:
- Visual Studio でプロジェクトを開く。
- Manage NuGet Packages に移動。
- GroupDocs.Redaction を検索し、最新の安定版をインストール。
ライセンス取得
製品を試すには、here から無料トライアルまたは一時ライセンスをリクエストしてください。temporary‑license page でも取得可能です。実運用では、機能制限のないフルライセンスを購入してすべての機能をアンロックしてください。
基本的な初期化と設定
以下は Redactor クラスでドキュメントを開くために必要な最小コードです。このスニペットは変更せずにそのまま使用してください。Redactor はドキュメントを表す主要クラスで、編集(赤字)ルールを適用するメソッドを提供します。
string sourceFile = "YOUR_DOCUMENT_DIRECTORY/sample.docx"; // Replace with actual path
using (Redactor redactor = new Redactor(sourceFile))
{
// Your redaction logic here
}
実装ガイド
ここからはカスタム IRedactionCallback を追加して、各編集(赤字)イベントを取得し、ログに書き込んだり、置換テキストを動的に変更したりします。
IRedactionCallback 実装のアタッチと使用
IRedactionCallback は各編集(赤字)操作のコールバックを受け取るインターフェイスで、プログラムからログ記録や動作変更が可能です。
手順 1: 出力ディレクトリとソースファイルパスの準備
ソースドキュメントが存在する場所を定義します。環境に合わせてパスを調整してください。
LoadOptions は SDK にファイルの読み取り方法(例: パスワード処理)を指示する設定オブジェクトです。
string sourceFile = "YOUR_DOCUMENT_DIRECTORY/sample.docx"; // Replace with actual path
手順 2: カスタム設定で Redactor インスタンスを作成
LoadOptions と RedactorSettings を使用して Redactor をインスタンス化します。設定内の RedactionDump が自動的にすべての編集(赤字)を記録します。
RedactorSettings で編集(赤字)プロセスを細かく調整でき、RedactionDump を渡すと詳細な監査ファイルが生成されます。RedactionDump は各編集(赤字)イベントを JSON 形式で書き出すヘルパークラスです。
using (Redactor redactor = new Redactor(sourceFile,
new LoadOptions(),
new RedactorSettings(new RedactionDump())))
{
// Further processing steps will go here
}
手順 3: 正確なフレーズの編集(赤字)を適用
ここではフレーズ John Doe をプレースホルダー [REDACTED] に置き換えます。隠したい任意のフレーズやパターンに置き換えて構いません。
ReplacementOptions は一致したコンテンツを何で置換するかを定義します。必要に応じてフォントや色のカスタマイズも可能です。
redactor.Apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions("[REDACTED]")));
主要オブジェクトの説明
LoadOptions()– SDK にドキュメントの読み取り方法(例: パスワード処理)を指示します。RedactorSettings(new RedactionDump())– 監査目的で各編集(赤字)をログに記録するダンプファイルを有効化します。ReplacementOptions("[REDACTED]")– マッチしたフレーズを置換するテキストを定義します。
これが重要な理由
コールバック機構はすべての編集(赤字)イベントを記録し、機械可読な監査トレイルを生成し、プレースホルダーを動的に変更できるため、コンプライアンス要件を満たし、手動の後処理作業を削減します。このデータを監視システムと統合すれば、レポート作成やアラート発生、機密情報が編集(赤字)パイプラインを通過しないことを保証できます。
IRedactionCallback を使用する具体的なメリットは次の 3 つです:
- コンプライアンス対応ログ – すべての編集(赤字)が機械可読なダンプに記録され、30 以上の規制フレームワークの監査要件を満たします。
- 動的置換 – データタイプに応じてプレースホルダーを変更でき、手動後処理を最大 40 % 削減します。
- スケーラブルなパフォーマンス – コールバックのオーバーヘッドはほぼ無視できるレベル (<2 ms/編集) で、数千ファイルを並列バッチ処理できます。
トラブルシューティングのヒント
- ファイルが見つからない:
sourceFileパスを再確認し、実行プロセスがファイルにアクセスできることを確認してください。 - コールバックが呼び出されない: クラスが
IRedactionCallbackの すべて のメンバーを実装しているか、インスタンスが正しくRedactorに渡されているかを確認してください。 - パフォーマンス低下: 大規模バッチの場合、可能な限り同じ
Redactorインスタンスを再利用し、使用後は速やかに破棄してください。
実用的な活用例
編集(赤字)された機密データは多くの業界で有用です:
- 法務文書処理 – クライアント名、事件番号、社会保障番号などを自動的に除去してドラフトを共有。
- 人事管理システム – 監査時に従業員契約書から個人識別子を削除。
- 財務報告 – 投資家向け PDF 作成時に機密数値や口座番号を隠蔽。
パフォーマンスに関する考慮点
GroupDocs.Redaction は 30 以上の入力・出力フォーマット(PDF、DOCX、PPTX、XLSX、HTML、画像形式など)をサポートし、数百ページのファイルでもメモリ全体にロードせずに処理できます。多数のファイルを扱う際にアプリケーションを高速に保つためのポイント:
- バッチ処理: ファイルリストを読み込み、
Parallel.ForEach内で編集(赤字)ループを実行し、マルチコアを活用。 - メモリ管理: 各
Redactorをusingブロックでラップし、確実に破棄。 - 非同期操作: SDK 自体は同期ですが、バックグラウンドスレッドや
Task.Runにオフロードすれば UI スレッドのブロックを回避できます。
よくある問題と解決策
| 問題 | 解決策 |
|---|---|
| 「Invalid file format」エラー | ドキュメントタイプがサポート対象(PDF、DOCX、PPTX など)か確認してください。 |
| コールバックが null を返す | RedactorSettings 作成時に具体的な IRedactionCallback 実装を渡しているか確認してください。 |
| 編集(赤字)が適用されない | 正確なフレーズが文書の大文字小文字やスペースと一致しているか、またはパターンベースの RegexRedaction を使用してください。 |
FAQ
Q: GroupDocs.Redaction のライセンスオプションは?
A: 無料トライアルまたは一時ライセンスで全機能を試せます。実運用では永続ライセンスまたはサブスクリプションライセンスを購入してください。
Q: 複数のファイルタイプに対応していますか?
A: はい、PDF、Word、Excel、PowerPoint など多数の一般的フォーマットをサポートしています。
Q: 編集(赤字)中に例外が発生した場合の対処は?
A: try‑catch ブロックでロジックを囲み、例外詳細をログに記録してください。コールバックでもリアルタイムにエラーを取得可能です。
Q: 非同期処理の組み込みサポートはありますか?
A: コア API は同期ですが、非同期タスクやバックグラウンドサービス内で呼び出すことで実現できます。
Q: さらに高度なサンプルはどこで見られますか?
A: 公式ドキュメント と API リファレンスに豊富なコード例とシナリオガイドがあります。
リソース
- GroupDocs.Redaction for Net Documentation
- GroupDocs.Redaction for Net API Reference
- Download GroupDocs.Redaction for Net
- GroupDocs.Redaction Forum
- Free Support
- Temporary License
Last Updated: 2026-10-06
Tested With: GroupDocs.Redaction 2.3 (latest at time of writing)
Author: GroupDocs