GroupDocs.Redaction for .NET を使用した注釈の編集方法

PDF または Word ファイルで 注釈を編集する方法 が必要な場合、適切な場所に来ました。このガイドでは、GroupDocs.Redaction for .NET のインストール、正規表現ベースの注釈編集の設定、大規模ワークロード向けのパフォーマンス最適化について説明します。最後まで読むと、数行の C# コードで機密コメント、メモ、その他のメタデータを非表示にできるようになります。

簡単な回答

  • どのライブラリが注釈の編集を処理しますか？ GroupDocs.Redaction for .NET.
  • 正規表現を使用できますか？ はい – API は完全な .NET 正規表現構文を受け入れます。
  • 開発にライセンスは必要ですか？ テストには無料トライアルが利用できますが、本番環境では有料ライセンスが必要です。
  • .NET 6 および .NET Core と互換性がありますか？ .NET Framework 4.5+、.NET Core 3.1+、および .NET 6+ で完全にサポートされています。
  • 大きなファイルでの編集はどれくらい速いですか？ 最適化されたパターンを使用すると、一般的なサーバーで 500 ページの PDF を 5 秒未満で処理できます。

注釈の編集とは何ですか？

注釈の編集は、文書のコメント、メモ、付箋、その他のメタデータオブジェクト内に存在するテキストを永久に削除または隠蔽します。この隠れた情報を消去することで、ファイルが配布されたり他のアプリケーションで開かれた場合でも機密データが抽出または閲覧されることを防ぎ、プライバシーとコンプライアンスを維持します。

PDF 注釈に編集を適用する理由は何ですか？

GroupDocs.Redaction は 30 以上のドキュメント形式 をサポートし、2 GB までのファイルをメモリに全体を読み込まずに処理できます。組み込みの正規表現エンジンを使用すると、手動の文字列検索と比較して処理時間が最大 70 % 短縮され、高ボリュームの法務や金融ワークフローに最適です。

前提条件

開始する前に、以下を確認してください：

  • GroupDocs.Redaction ライブラリ（最新の NuGet バージョン）。
  • 互換性のある .NET ランタイム（Framework 4.5+、.NET Core 3.1+、.NET 5/6）。
  • Visual Studio 2022 や VS Code などの IDE。
  • 基本的な C# の知識と正規表現の知識。

GroupDocs.Redaction を使用して注釈を編集する方法は？

ソースドキュメントを読み込み、正規表現パターンを定義し、AnnotationRedaction を適用して結果を保存します—すべて簡潔な 3 ステップのフローです。以下のセクションでは、各ステップを明確な説明と、独自の値に置き換える正確なコードプレースホルダーで分解しています。

ステップ 1 – .NET CLI でライブラリをインストール

回答: プロジェクト フォルダーで dotnet add package GroupDocs.Redaction を実行します。CLI が最新の安定パッケージをダウンロードし、プロジェクト ファイルを自動的に更新します。

dotnet add package GroupDocs.Redaction

ステップ 2 – パッケージ マネージャー コンソールでライブラリをインストール

回答: Visual Studio のパッケージ マネージャー コンソールで Install-Package GroupDocs.Redaction を実行します。コマンドは依存関係を解決し、プロジェクトへの参照を追加します。

Install-Package GroupDocs.Redaction

ステップ 3 – Redactor の初期化 (definition anchor)

Redactor クラスは、ドキュメントを読み込み、編集ルールを適用するコアエンジンです。

using System;
using GroupDocs.Redaction.Redactions;

namespace DocumentRedaction
{
    class Program
    {
        static void Main(string[] args)
        {
            string sourceFile = @"YOUR_DOCUMENT_DIRECTORY\annotated.xlsx"; // Replace with actual document path.
            
            using (Redactor redactor = new Redactor(sourceFile))
            {
                // Your redaction logic will go here.
            }
        }
    }
}

注釈の編集を適用する

ステップ 1: Redactor インスタンスの作成 (definition anchor)

Redactor はすべての編集操作のエントリーポイントで、コンストラクタにソース ファイル パスを渡します。

using (Redactor redactor = new Redactor(sourceFile))
{
    // Further processing will occur here.
}

ステップ 2: 正規表現を定義する (definition anchor)

Regex はパターンを評価する .NET クラスで、パターン内で直接大文字小文字の区別なし (i) とマルチラインモード (m) を有効にできます。

string pattern = "(?im:john)";
  • (?im...): 大文字小文字の区別なし (i) とマルチライン検索 (m) を有効にします。

ステップ 3: 編集を適用する (definition anchor)

AnnotationRedaction は注釈オブジェクトをスキャンし、一致するテキストを黒い矩形で置き換える特殊なルールです。

redactor.Apply(new AnnotationRedaction(pattern));

説明:

  • パラメーター: 正規表現パターンはエンジンに対象テキストを指示します。
  • 戻り値: このメソッドはドキュメントをその場で変更し、戻り値は必要ありません。

ステップ 4: 編集済みドキュメントを保存する (definition anchor)

Redactor.Save は変更されたファイルをディスクに書き込み、特に指定しない限り元の形式を保持します。

guardedRedactor.Save();

一般的な問題と解決策

  • 一致が見つかりません: 正規表現の構文を再確認し、同じ .NET エンジンを使用したオンラインテスターを利用してください。
  • ファイルアクセスエラー: アプリケーションがソースおよび宛先フォルダーに対して読み取り/書き込み権限を持っていることを確認してください。
  • パフォーマンスのボトルネック: 500 ページ以上のドキュメントは、並列でバッチ処理し、可能な限り単一の Redactor インスタンスを再利用してください。

よくある質問

Q: パスワードで保護された PDF の注釈を編集できますか？
A: はい。Redactor(string path, string password) でドキュメントを開き、通常どおり編集ルールを適用します。

Q: GroupDocs.Redaction は元のファイルを変更しますか？
A: API はメモリ内のコピーで動作し、Save を明示的に呼び出すまで元のファイルは変更されません。

Q: どのくらいの注釈タイプがサポートされていますか？
A: コメント、ハイライト、付箋など、すべての標準的な PDF 注釈タイプが完全にサポートされています。

Q: 保存前に編集結果をプレビューする方法はありますか？
A: Redactor.GetRedactedDocument() を使用してメモリ内ストリームを取得し、UI にレンダリングして簡単にプレビューできます。

Q: 処理可能な最大ファイルサイズはどれくらいですか？
A: このライブラリは 2 GB までのファイルを処理できます。より大きなファイルは処理前に分割してください。

FAQ セクション

  1. GroupDocs.Redaction とは何ですか？

    • さまざまなドキュメント形式から機密情報を編集するための .NET ライブラリです。

  2. 複雑な注釈はどう処理しますか？

    • 高度な正規表現を使用し、重要なドキュメントに適用する前に十分にテストしてください。

  3. 編集を元に戻すことは可能ですか？

    • 保存すると変更は永続的です。常に元のファイルをバックアップしてください。

  4. 既存のアプリケーションに GroupDocs.Redaction を統合できますか？

    • はい、API は他の .NET ベースのシステムとシームレスに統合できます。

  5. GroupDocs.Redaction がサポートする形式は何ですか？

    • Word、PDF、Excel など、幅広いドキュメントタイプをサポートしています。

リソース

最終更新日: 2026-05-27
テスト済み: GroupDocs.Redaction 23.10 for .NET
作者: GroupDocs

関連チュートリアル