在原始格式中保存已编辑文档 使用 GroupDocs.Redaction .NET

对敏感数据进行编辑是常见的合规需求，但您不想失去原始文件的外观和感觉。本教程展示了如何在保持原始格式完整的情况下保存已编辑文档，使用 GroupDocs.Redaction for .NET。您将获得一个可直接运行的解决方案，支持 PDF、Word 文件等。

快速答案

  • 保存已编辑文档的最快方法是什么？ 使用 Redactor 加载文件，应用 ExactPhraseRedaction，然后使用保持原始文件类型的 SaveOptions 调用 Save。
  • 支持哪些格式？ 超过 30 种格式，包括 PDF、DOCX、PPTX 和图像类型。
  • 试用是否需要许可证？ 是的 – 从 GroupDocs 门户获取临时许可证。
  • 我可以为保存的文件添加自定义后缀吗？ 当然可以 – 将 SaveOptions.Suffix 设置为任意字符串（例如日期）。
  • 大文件处理是否内存高效？ 是的 – GroupDocs.Redaction 采用流式处理，永不将整个文件加载到内存中。

什么是“保存已编辑文档”？

保存已编辑文档 指将修改后的文件写回存储，同时保留原始布局、文件类型和元数据。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") 加载源文件，应用一个或多个编辑，配置 SaveOptions 以保持原始格式并添加后缀（例如 “_redacted”），然后调用 redactor.Save("output.pdf", saveOptions)。此单步工作流确保输出保留与输入文件相同的布局、字体和元数据，同时永久删除已编辑的内容。

常见问题及解决方案

  • 文档未加载 – 验证文件路径并确保进程具有读取权限。
  • 编辑失败 – 再次检查精确短语的拼写和大小写敏感性；如有需要使用 IgnoreCase = true。
  • 输出文件损坏 – 确保 SaveOptions 与源格式匹配；不匹配的类型可能导致结果损坏。

实际应用

GroupDocs.Redaction .NET 在受监管行业中表现出色：

  1. 法律文档管理 – 在共享合同前自动去除客户姓名、社会安全号或案件编号。
  2. 医疗数据隐私 – 在医疗记录中遮蔽患者标识符，以符合 HIPAA 要求。
  3. 财务报告 – 在分发季度报告前删除机密账户号码。

性能考虑

处理大文件（数百兆）时，请遵循以下最佳实践：

  • 使用简洁的搜索模式以降低 CPU 周期。
  • 及时释放 Redactor 实例（使用 using 块），以释放非托管资源。
  • 利用 SaveOptions.Streaming = true 保持低内存占用。

结论

现在，您已经拥有使用 GroupDocs.Redaction for .NET 在原始格式中 保存已编辑文档 的完整、可投入生产的方法。按照上述步骤，您可以将安全编辑嵌入任何 .NET 工作流，确保合规性而不牺牲文档完整性。

探索高级功能，如批量编辑、自定义编辑形状以及与云存储的集成，以进一步扩展您的解决方案。

常见问题

Q: GroupDocs.Redaction 能处理哪些文件类型？
A: 超过 30 种格式，包括 PDF、DOCX、PPTX、XLSX，以及常见的图像类型如 PNG 和 JPEG。

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

相关教程