Redact documents with GroupDocs.Redaction Leave feedback
On this page
GroupDocs.Redaction removes sensitive information from a document rather than merely hiding it — the redacted text is gone from the file, not covered by a black box you can drag away. It redacts text, metadata, annotations and image regions, and can rasterise the result to PDF so the original content cannot be recovered.
ExactPhraseRedaction replaces every occurrence of a phrase. ReplacementOptions decides what takes its place. The contract names its engagement Project Northlight in the body — that codename is what a redacted copy has to lose.
using System;
using System.IO;
using GroupDocs.Redaction;
using GroupDocs.Redaction.Options;
using GroupDocs.Redaction.Redactions;
using (Redactor redactor = new Redactor("contract-v1.docx"))
{
RedactorChangeLog result = redactor.Apply(
new ExactPhraseRedaction("Project Northlight", new ReplacementOptions("[REDACTED]")));
Console.WriteLine("Status: " + result.Status);
if (result.Status != RedactionStatus.Failed)
{
// Save() has no path overload: SaveOptions writes back over the source.
// Write to a stream to keep the original intact.
using (FileStream output = File.Create("redaction-exact-phrase.docx"))
{
redactor.Save(output, new RasterizationOptions { Enabled = false });
}
}
}
contract-v1.docx is the sample file used in this example. Click here to download it.
Binary file (DOCX, 15 KB)
A regex redaction catches patterns rather than literals — account numbers, amounts, email addresses — which is what most compliance rules are actually written against.
using System;
using System.IO;
using GroupDocs.Redaction;
using GroupDocs.Redaction.Options;
using GroupDocs.Redaction.Redactions;
using (Redactor redactor = new Redactor("contract-v1.docx"))
{
// Any currency amount such as "120,000 USD"
RedactorChangeLog result = redactor.Apply(
new RegexRedaction(@"\d{1,3}(,\d{3})*\s?USD", new ReplacementOptions("[AMOUNT]")));
Console.WriteLine("Status: " + result.Status);
if (result.Status != RedactionStatus.Failed)
{
// Save() has no path overload: SaveOptions writes back over the source.
// Write to a stream to keep the original intact.
using (FileStream output = File.Create("redaction-regex.docx"))
{
redactor.Save(output, new RasterizationOptions { Enabled = false });
}
}
}
contract-v1.docx is the sample file used in this example. Click here to download it.
Binary file (DOCX, 15 KB)
Redacting the visible text is only half the job — the author, the revision history and the original filename usually live in the metadata. EraseMetadataRedaction clears them.
using System;
using System.IO;
using GroupDocs.Redaction;
using GroupDocs.Redaction.Options;
using GroupDocs.Redaction.Redactions;
using (Redactor redactor = new Redactor("contract-v1.docx"))
{
RedactorChangeLog result = redactor.Apply(
new EraseMetadataRedaction(MetadataFilters.All));
Console.WriteLine("Status: " + result.Status);
if (result.Status != RedactionStatus.Failed)
{
// Save() has no path overload: SaveOptions writes back over the source.
// Write to a stream to keep the original intact.
using (FileStream output = File.Create("redaction-metadata.docx"))
{
redactor.Save(output, new RasterizationOptions { Enabled = false });
}
}
}
contract-v1.docx is the sample file used in this example. Click here to download it.
Binary file (DOCX, 15 KB)
TipSettingEnabled = trueonRasterizationOptionsconverts each page to an image inside a PDF. It is the strongest option — no text layer survives for anyone to recover — at the cost of the result no longer being searchable or editable. TheSaveOptionsoverload spells the same thingRasterizeToPDF.
GroupDocs.Redaction also redacts image areas, deletes or rewrites annotations, removes whole pages, applies several redactions in one pass, and supports custom redaction policies loaded from configuration.
- GroupDocs.Redaction for .NET documentation — the full product guide
- Supported file formats
- API reference
Was this page helpful?
Any additional feedback you'd like to share with us?
Please tell us how we can improve this page.
Thank you for your feedback!
We value your opinion. Your feedback will help us improve our documentation.
