GroupDocs.Redaction .NET を使用して元の形式で編集済みドキュメントを保存する

機密データの編集は一般的なコンプライアンス要件ですが、元のファイルの外観や感触を失いたくありません。このチュートリアルでは、元の形式を維持したまま編集済みドキュメントを保存する方法を示します。GroupDocs.Redaction for .NET を使用します。PDF、Word ファイルなどで動作するすぐに実行できるソリューションが得られます。

クイック回答

  • 編集済みドキュメントを保存する最速の方法は何ですか？ ファイルを Redactor で読み込み、ExactPhraseRedaction を適用し、元のファイルタイプを保持する SaveOptions を使用して Save を呼び出します。
  • サポートされている形式は何ですか？ PDF、DOCX、PPTX、画像タイプなど、30 以上の形式がサポートされています。
  • 試用版の使用にライセンスは必要ですか？ はい – GroupDocs ポータルから一時ライセンスを取得してください。
  • 保存ファイルにカスタムサフィックスを追加できますか？ もちろんです – 任意の文字列（例: 日付）を SaveOptions.Suffix に設定します。
  • 大容量ファイルの処理はメモリ効率が良いですか？ はい – GroupDocs.Redaction はデータをストリーミングし、ファイル全体をメモリに読み込むことはありません。

「編集済みドキュメントを保存する」とは何ですか？

Saving a redacted document は、変更されたファイルを元のレイアウト、ファイルタイプ、メタデータを保持したままストレージに書き戻すことを意味します。GroupDocs.Redaction はこれを単一の呼び出しで処理し、手動の形式変換の必要性を排除します。このプロセスはフォント、画像、ドキュメントプロパティなどの埋め込みリソースも保持し、削除されたコンテンツ以外は出力が元と同一に見えるようにします。

.NET 用の GroupDocs.Redaction を使用する理由は？

GroupDocs.Redaction は 30 以上の入力および出力形式 をサポートし、500 MB までのファイルをドキュメント全体をメモリに読み込むことなく処理でき、素朴なファイル書き換え手法に比べて 20‑30 % のパフォーマンス向上 を実現します。API は完全にマネージドで、外部ソフトウェアを必要とせず、GDPR、HIPAA、その他の規制に準拠しています。

前提条件

  • GroupDocs.Redaction for .NET – コアライブラリ（最新の安定版）。
  • .NET 6+ または .NET Framework 4.7.2+ が開発マシンにインストールされていること。
  • 基本的な C# の知識と、Visual Studio または好みの IDE に慣れていること。

必要なライブラリと依存関係

  • GroupDocs.Redaction for .NET: 赤字適用に必須です。

環境設定要件

  • プロジェクトがサポートされている .NET ランタイムを対象としていることを確認してください。正確なバージョンマトリックスは公式の GroupDocs ドキュメントをご参照ください。

知識の前提条件

  • C# の構文、ファイル I/O、例外処理の理解。

GroupDocs.Redaction for .NET の設定

インストール手順

.NET CLI を使用:

dotnet add package GroupDocs.Redaction

Package Manager Console を使用:

Install-Package GroupDocs.Redaction

NuGet パッケージマネージャ UI 経由:

  • Visual Studio で NuGet パッケージマネージャを開きます。
  • “GroupDocs.Redaction” を検索し、最新バージョンをインストールします。

ライセンス取得

機能をテストするために無料トライアルから始めます。必要に応じて GroupDocs のウェブサイトで一時ライセンスをリクエストしてください。長期利用の場合は、サイトからライセンスを購入することを検討してください。

インストールとライセンス認証が完了したら、コードファイルで GroupDocs.Redaction 名前空間を参照してください：

using GroupDocs.Redaction;

実装ガイド

Redactor の作成と構成

Redactor クラスは、ドキュメントを読み込み、編集操作を適用するコアコンポーネントです。

ステップ 1: Redactor の初期化

Redactor クラスのインスタンスを、ドキュメントのファイルパスで作成します：

string sourceFile = "YOUR_DOCUMENT_DIRECTORY"; // Replace with actual path.
using (Redactor redactor = new Redactor(sourceFile))
{
    ...
}

ステップ 2: Exact Phrase Redaction の適用

ExactPhraseRedaction は、正確な文字列を検索し、黒い矩形またはカスタムテキストで置き換える組み込みの編集タイプです。

// This replaces all instances of "John Doe" with "[personal]".
redactor.Apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions("[personal]"));

編集済みドキュメントの保存

サフィックスを追加しつつ元の形式を保持するには SaveOptions が使用されます。

ステップ 3: Save Options の構成

SaveOptions を使用すると、ソースファイルタイプを保持し、サフィックスを指定し、メモリ使用量を制御できます。

var saveOptions = new SaveOptions() 
{
    AddSuffix = true,                  // Adds a suffix like "2023-10-12" to indicate modification.
    RasterizeToPDF = false,           // Ensures the document remains in its original format.
    RedactedFileSuffix = DateTime.Now.ToShortDateString()
};

ステップ 4: 保存と出力

構成したオプションで Save メソッドを呼び出し、編集済みファイルをディスクに書き込みます：

var outputFile = redactor.Save(saveOptions);
Console.WriteLine($"\nSource document was redacted successfully.\nFile saved to {outputFile}.\n");

元の形式を保持しながら編集済みドキュメントを保存する方法は？

new Redactor("source.pdf") でソースファイルを読み込み、1 つ以上の編集を適用し、元の形式を保持しサフィックス（例: “_redacted”）を追加するように SaveOptions を構成し、redactor.Save("output.pdf", saveOptions) を呼び出します。この単一ステップのワークフローにより、出力は入力ファイルと同じレイアウト、フォント、メタデータを保持し、編集されたコンテンツは永久に削除されます。

一般的な問題と解決策

  • Document Not Loading – ファイルパスを確認し、プロセスに読み取り権限があることを確認してください。
  • Redaction Fails – 正確なフレーズのスペルと大文字小文字の区別を再確認してください。必要に応じて IgnoreCase = true を使用します。
  • Output File Corrupt – SaveOptions がソース形式と一致していることを確認してください。タイプが不一致だと結果が破損する可能性があります。

実用的な適用例

GroupDocs.Redaction .NET は規制産業で特に有用です：

  1. Legal Document Management – 契約書を共有する前に、クライアント名、SSN、ケース番号などを自動的に除去します。
  2. Healthcare Data Privacy – 医療記録の患者識別子をマスクし、HIPAA 準拠を維持します。
  3. Financial Reporting – 四半期報告書の配布前に機密の口座番号を除去します。

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

数百メガバイトの大きなファイルを扱う際は、以下のベストプラクティスに従ってください：

  • CPU サイクルを削減するために、簡潔な検索パターンを使用します。
  • Redactor インスタンスは速やかに破棄（using ブロック）して、アンマネージドリソースを解放します。
  • メモリフットプリントを低く保つために SaveOptions.Streaming = true を活用します。

結論

これで、GroupDocs.Redaction for .NET を使用して元の形式で 編集済みドキュメントを保存 する完全な本番対応の方法が手に入りました。上記の手順に従うことで、任意の .NET ワークフローに安全な編集を組み込むことができ、ドキュメントの忠実性を損なうことなくコンプライアンスを確保できます。

バッチ編集、カスタム編集形状、クラウドストレージとの統合などの高度な機能を探求し、ソリューションをさらに拡張してください。

よくある質問

Q: GroupDocs.Redaction が扱えるファイルタイプは何ですか？
A: PDF、DOCX、PPTX、XLSX、PNG や JPEG などの一般的な画像タイプを含む、30 以上の形式に対応しています。

Q: 保存前に編集内容をプレビューできますか？
A: はい – Redactor クラスは GetRedactions() メソッドを提供し、UI に表示できるコレクションを返します。

Q: パスワード保護されたドキュメントを編集できますか？
A: もちろんです。Redactor インスタンスを作成する際にパスワードを指定してファイルのロックを解除してください。

Q: ライブラリは .NET Core と .NET 5/6 をサポートしていますか？
A: はい – NuGet パッケージは .NET Framework 4.7.2+、.NET Core 3.1+、および .NET 5/6+ と互換性があります。

Q: 本番用ライセンスはどのように取得しますか？
A: GroupDocs のウェブサイトからライセンスを購入してください。評価用の一時トライアルライセンスも利用可能です。

リソース

最終更新日： 2026-07-06
テスト済みバージョン： GroupDocs.Redaction 2.0.0 for .NET
作者： GroupDocs

関連チュートリアル