.NETでGroupDocs.Redactionを使用してPDFを編集する方法

In today’s fast‑moving digital world, PDFを編集する方法 files reliably is a question many developers ask. Whether you’re protecting client data, stripping confidential clauses from legal contracts, or simply removing unwanted text from a report, mastering PDF redaction in .NET gives you full control over privacy. This guide walks you through every step of using GroupDocs.Redaction to PDFテキストの削除, 医療記録の編集, and 編集済みPDFの保存 files safely.

クイック回答

  • .NETでPDF編集を扱うライブラリは何ですか？ GroupDocs.Redaction for .NET.
  • 特定のフレーズだけを編集できますか？ Yes – use regular expressions or a custom handler.
  • 本番環境でライセンスは必要ですか？ A valid GroupDocs license is needed for production use.
  • 元のレイアウトは保持されますか？ The redaction engine keeps page layout intact while obscuring content.
  • 最終ファイルはどうやって保存しますか？ Call Redactor.Save with a SaveOptions instance to create the redacted PDF.

PDF編集とは何か、そしてなぜ重要なのか

PDF redaction permanently removes or masks sensitive information so it cannot be recovered. Unlike simple hiding, redaction overwrites the underlying data, ensuring compliance with regulations such as GDPR, HIPAA, and PCI‑DSS. Using GroupDocs.Redaction, you can automate this process directly from your .NET applications.

前提条件

  • GroupDocs.Redaction for .NET (ライブラリへのアクセス)。
  • .NET Framework 4.6+ または .NET Core 3.1+ (任意の最新 .NET ランタイム)。
  • Visual Studio や VS Code など、C# に対応した IDE。
  • パターンマッチングのための正規表現の基本知識。

.NET 用 GroupDocs.Redaction の設定

まず、プロジェクトにライブラリを追加します。

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

NuGet Package Manager UI
“GroupDocs.Redaction” を検索し、最新バージョンをインストールします。

ライセンス取得手順

  • Free Trial: 一時的なライセンスにアクセスしてフル機能を試せます。
  • Purchase: 長期利用のために、GroupDocs からサブスクリプションを購入します。

パッケージがインストールされたら、処理したい PDF を指す Redactor インスタンスを作成できます。

カスタムハンドラを使用したPDFの編集方法

カスタム編集により細かい制御が可能になり、医療記録の編集 のように特定のパターンを対象とするシナリオに最適です。

手順実装

手順 1: ソースと宛先のパスを定義

string sourceFile = "YOUR_DOCUMENT_DIRECTORY/LOREMIPSUM_PDF.pdf";

手順 2: 正規表現と置換オプションの構築

ここではフローを示すためにシンプルな .* パターンを使用します。実際の使用例では、より正確な正規表現（例: SSN、クレジットカード番号）に置き換えてください。

Regex regex = new Regex(".*");
ReplacementOptions optionsText = new ReplacementOptions("[replaced]");
optionsText.CustomRedaction = new TextRedactor();

手順 3: 編集を作成して適用

PageAreaRedaction オブジェクトは正規表現をカスタムハンドラに結び付けます。

var textRedaction = new PageAreaRedaction(regex, optionsText);
var redactions = new Redaction[] { textRedaction };

using (Redactor redactor = new Redactor(sourceFile))
{
    RedactorChangeLog result = redactor.Apply(redactions);
    if (result.Status != RedactionStatus.Failed)
    {
        var outputFile = redactor.Save(new Options.SaveOptions(false, "Custom_Redaction_Result"));
        // Output file saved to YOUR_OUTPUT_DIRECTORY.
    }
    else
    {
        Console.WriteLine("Custom redaction failed");
    }
}

手順 4: カスタム編集ハンドラの実装

ハンドラにより、マッチしたテキストを必要な形で正確に書き換えることができます。

public class TextRedactor : ICustomRedactionHandler
{
    public CustomRedactionResult Redact(CustomRedactionContext context)
    {
        CustomRedactionResult result = new CustomRedactionResult();
        
        try
        {
            Regex regex = new Regex(@"Lorem ipsum");
            if (regex.IsMatch(context.Text))
            {
                string redactedText = regex.Replace(context.Text, "[redacted‑custom]");
                result.Apply = true;
                result.Text = redactedText;
            }
        }
        catch (System.Exception ex)
        {
            result.Apply = false;
        }

        return result;
    }
}

カスタムハンドラを使用する理由

  • Precision – 必要な正確なフレーズだけを対象にします。
  • Flexibility – カスタム文字列、マスク、あるいは画像でテキストを置換できます。
  • Compliance – 削除されたデータが復元できないことを保証し、法的基準を満たします。

トラブルシューティングのヒント

  • 正規表現の構文を再確認してください。小さなミスでも対象テキストがスキップされる可能性があります。
  • アプリケーションがソースおよび出力フォルダに対して読み書き権限を持っていることを確認してください。
  • RedactorChangeLog を使用して、どのページが変更されたかを確認してください。

実用的なユースケース

シナリオ編集が助けること
法務文書共有前にクライアント名、ケース番号、機密条項を隠します。
財務報告書口座番号、残高、または独自の数式を削除します。
医療記録医療記録の編集 を行い、ケーススタディを共有する際に HIPAA に準拠します。
社内メモ外部に送信する PDF から内部プロジェクトコードやパスワードを除去します。
文書管理システム大規模な文書ライブラリ全体でプライバシー保護を自動化します。

パフォーマンス考慮事項

  • Chunk Processing – 非常に大きな PDF の場合、ページをバッチ処理してメモリ使用量を抑えます。
  • Efficient Regex – マッチングを高速化するため、コンパイル済み正規表現 (new Regex(pattern, RegexOptions.Compiled)) を使用します。
  • Dispose Promptly – Redactor を using ブロックでラップ（上記参照）し、ファイルハンドルを即座に解放します。

結論

これで、GroupDocs.Redaction を使用して .NET で PDFを編集する方法 の完全な本番対応ワークフローが手に入りました。カスタムハンドラを活用することで、PDFテキストの削除、医療記録の編集、そして厳格なプライバシー要件を満たす 編集済みPDFの保存 が可能です。

次のステップ

  • GroupDocs ドキュメント をさらに深く調査する。
  • より複雑な正規表現パターン（例: クレジットカード番号、メールアドレス）を試す。
  • 既存の文書管理パイプラインに編集サービスを統合する。

よくある質問

Q: パスワード保護された PDF を編集できますか？
A: はい。Redactor インスタンスを作成する前に、適切なパスワードでドキュメントを開きます。

Q: GroupDocs.Redaction は画像の編集をサポートしていますか？
A: もちろんです。テキスト編集と同時に、画像ベースの編集領域を定義できます。

Q: 編集済み PDF が HIPAA に準拠していることをどう確認しますか？
A: カスタムハンドラで PHI パターンを対象にし、RedactorChangeLog を確認し、編集操作の監査ログを保持します。

Q: 数千の PDF を自動的に編集する必要がある場合は？
A: ファイルを反復処理し、同じ編集ルールを適用して、指定された出力フォルダに結果を書き込むバッチプロセッサを構築します。

Q: 保存前に編集内容をプレビューする方法はありますか？
A: Redactor.GetRedactionPreview()（新しいバージョンで利用可能）を呼び出すことで、各ページのプレビュー画像を生成できます。

リソース

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