API Reference

Class

PdfDocumentRedactions

Namespace OfficeIMO.Pdf
Assembly OfficeIMO.Pdf
Modifiers sealed

Permanent redaction operations for one PDF document.

Inheritance

  • Object
  • PdfDocumentRedactions

Usage

This type appears in these public API surfaces even when no hand-authored example is attached directly to the page.

Returned or exposed by

Methods

public PdfDocument AddAnnotation(PdfRedactionAnnotationOptions options) #
Returns: PdfDocument

Adds standard PDF /Redact review annotations for every canonical area in a region.

Parameters

options OfficeIMO.Pdf.PdfRedactionAnnotationOptions requiredposition: 0
Apply 2 overloads
public PdfDocument Apply(IEnumerable<PdfRedactionArea> areas, PdfRedactionApplyOptions applyOptions = null, PdfTextLayoutOptions layoutOptions = null, PdfLoadOptions options = null) #
Returns: PdfDocument

Creates a new PDF with intersecting content and annotations removed from the supplied areas.

Parameters

areas System.Collections.Generic.IEnumerable{OfficeIMO.Pdf.PdfRedactionArea} requiredposition: 0
applyOptions OfficeIMO.Pdf.PdfRedactionApplyOptions = null optionalposition: 1
layoutOptions OfficeIMO.Pdf.PdfTextLayoutOptions = null optionalposition: 2
options OfficeIMO.Pdf.PdfLoadOptions = null optionalposition: 3
public PdfDocument Apply(PdfRedactionPlan plan, PdfRedactionApplyOptions applyOptions = null, PdfTextLayoutOptions layoutOptions = null, PdfLoadOptions options = null) #
Returns: PdfDocument

Applies a reviewed redaction plan, including exact field removal.

Parameters

plan OfficeIMO.Pdf.PdfRedactionPlan requiredposition: 0
applyOptions OfficeIMO.Pdf.PdfRedactionApplyOptions = null optionalposition: 1
layoutOptions OfficeIMO.Pdf.PdfTextLayoutOptions = null optionalposition: 2
options OfficeIMO.Pdf.PdfLoadOptions = null optionalposition: 3
public PdfOperationResult<PdfDocument> ApplyResult(IEnumerable<PdfRedactionArea> areas, PdfRedactionApplyOptions applyOptions = null, PdfTextLayoutOptions layoutOptions = null, PdfLoadOptions options = null) #
Returns: PdfOperationResult<PdfDocument>

Attempts to apply redactions and returns preflight diagnostics when blocked.

Parameters

areas System.Collections.Generic.IEnumerable{OfficeIMO.Pdf.PdfRedactionArea} requiredposition: 0
applyOptions OfficeIMO.Pdf.PdfRedactionApplyOptions = null optionalposition: 1
layoutOptions OfficeIMO.Pdf.PdfTextLayoutOptions = null optionalposition: 2
options OfficeIMO.Pdf.PdfLoadOptions = null optionalposition: 3
public PdfRedactionApplyResult ApplyWithEvidence(PdfRedactionPlan plan, PdfRedactionApplyOptions applyOptions = null, PdfRedactionVerificationOptions verificationOptions = null, PdfTextLayoutOptions layoutOptions = null, PdfLoadOptions options = null) #
Returns: PdfRedactionApplyResult

Applies a source-bound reviewed plan and returns the rewritten PDF, selected mutation path, and actual-versus-planned evidence from the rewritten artifact.

Parameters

plan OfficeIMO.Pdf.PdfRedactionPlan requiredposition: 0
applyOptions OfficeIMO.Pdf.PdfRedactionApplyOptions = null optionalposition: 1
verificationOptions OfficeIMO.Pdf.PdfRedactionVerificationOptions = null optionalposition: 2
layoutOptions OfficeIMO.Pdf.PdfTextLayoutOptions = null optionalposition: 3
options OfficeIMO.Pdf.PdfLoadOptions = null optionalposition: 4
public PdfOperationResult<PdfRedactionApplyResult> ApplyWithEvidenceResult(PdfRedactionPlan plan, PdfRedactionApplyOptions applyOptions = null, PdfRedactionVerificationOptions verificationOptions = null, PdfTextLayoutOptions layoutOptions = null, PdfLoadOptions options = null) #
Returns: PdfOperationResult<PdfRedactionApplyResult>

Attempts to apply a reviewed plan and returns diagnostics instead of throwing when the mutation is blocked or fails.

Parameters

plan OfficeIMO.Pdf.PdfRedactionPlan requiredposition: 0
applyOptions OfficeIMO.Pdf.PdfRedactionApplyOptions = null optionalposition: 1
verificationOptions OfficeIMO.Pdf.PdfRedactionVerificationOptions = null optionalposition: 2
layoutOptions OfficeIMO.Pdf.PdfTextLayoutOptions = null optionalposition: 3
options OfficeIMO.Pdf.PdfLoadOptions = null optionalposition: 4
public PdfRedactionVerificationReport AssertAppliedPlan(PdfRedactionPlan reviewedPlan, PdfRedactionVerificationOptions options) #
Returns: PdfRedactionVerificationReport

Verifies a reviewed plan and throws when planned content remains in its areas.

Parameters

reviewedPlan OfficeIMO.Pdf.PdfRedactionPlan requiredposition: 0
options OfficeIMO.Pdf.PdfRedactionVerificationOptions requiredposition: 1
public PdfRedactionVerificationReport AssertVerified(PdfRedactionVerificationOptions options) #
Returns: PdfRedactionVerificationReport

Verifies configured markers and throws when redaction proof fails.

Parameters

options OfficeIMO.Pdf.PdfRedactionVerificationOptions requiredposition: 0
Plan 4 overloads
public PdfRedactionPlan Plan(IEnumerable<PdfRedactionRegion> regions, PdfTextLayoutOptions layoutOptions = null, PdfLoadOptions options = null) #
Returns: PdfRedactionPlan

Plans one or more rich review regions while retaining their exact destructive geometry.

Parameters

regions System.Collections.Generic.IEnumerable{OfficeIMO.Pdf.PdfRedactionRegion} requiredposition: 0
layoutOptions OfficeIMO.Pdf.PdfTextLayoutOptions = null optionalposition: 1
options OfficeIMO.Pdf.PdfLoadOptions = null optionalposition: 2
public PdfRedactionPlan Plan(IEnumerable<PdfRedactionRegion> regions, CancellationToken cancellationToken, PdfTextLayoutOptions layoutOptions = null, PdfLoadOptions options = null) #
Returns: PdfRedactionPlan

Plans rich review regions with cooperative cancellation.

Parameters

regions System.Collections.Generic.IEnumerable{OfficeIMO.Pdf.PdfRedactionRegion} requiredposition: 0
cancellationToken System.Threading.CancellationToken requiredposition: 1
layoutOptions OfficeIMO.Pdf.PdfTextLayoutOptions = null optionalposition: 2
options OfficeIMO.Pdf.PdfLoadOptions = null optionalposition: 3
public PdfRedactionPlan Plan(IEnumerable<PdfRedactionArea> areas, PdfTextLayoutOptions layoutOptions = null, PdfLoadOptions options = null) #
Returns: PdfRedactionPlan

Plans rectangle-based redaction impact without modifying the PDF.

Parameters

areas System.Collections.Generic.IEnumerable{OfficeIMO.Pdf.PdfRedactionArea} requiredposition: 0
layoutOptions OfficeIMO.Pdf.PdfTextLayoutOptions = null optionalposition: 1
options OfficeIMO.Pdf.PdfLoadOptions = null optionalposition: 2
public PdfRedactionPlan Plan(IEnumerable<PdfRedactionArea> areas, CancellationToken cancellationToken, PdfTextLayoutOptions layoutOptions = null, PdfLoadOptions options = null) #
Returns: PdfRedactionPlan

Plans rectangle-based redaction impact with cooperative cancellation.

Parameters

areas System.Collections.Generic.IEnumerable{OfficeIMO.Pdf.PdfRedactionArea} requiredposition: 0
cancellationToken System.Threading.CancellationToken requiredposition: 1
layoutOptions OfficeIMO.Pdf.PdfTextLayoutOptions = null optionalposition: 2
options OfficeIMO.Pdf.PdfLoadOptions = null optionalposition: 3
public PdfRedactionPlan PlanAnnotations(PdfTextLayoutOptions layoutOptions = null, PdfLoadOptions options = null) #
Returns: PdfRedactionPlan

Builds a source-bound plan from standard PDF /Redact annotations already present in the document.

Parameters

layoutOptions OfficeIMO.Pdf.PdfTextLayoutOptions = null optionalposition: 0
options OfficeIMO.Pdf.PdfLoadOptions = null optionalposition: 1
public PdfRedactionPlan Search(PdfRedactionSearchOptions search, PdfTextLayoutOptions layoutOptions = null, PdfLoadOptions options = null) #
Returns: PdfRedactionPlan

Searches literal text, regex, logical kinds, and form-field names into a reviewable plan.

Parameters

search OfficeIMO.Pdf.PdfRedactionSearchOptions requiredposition: 0
layoutOptions OfficeIMO.Pdf.PdfTextLayoutOptions = null optionalposition: 1
options OfficeIMO.Pdf.PdfLoadOptions = null optionalposition: 2
public PdfRedactionVerificationReport Verify(PdfRedactionVerificationOptions options) #
Returns: PdfRedactionVerificationReport

Verifies configured removed and retained markers in the rewritten PDF.

Parameters

options OfficeIMO.Pdf.PdfRedactionVerificationOptions requiredposition: 0
public PdfRedactionVerificationReport VerifyAppliedPlan(PdfRedactionPlan reviewedPlan, PdfRedactionVerificationOptions options) #
Returns: PdfRedactionVerificationReport

Verifies configured markers and reports any content still intersecting the reviewed plan areas.

Parameters

reviewedPlan OfficeIMO.Pdf.PdfRedactionPlan requiredposition: 0
options OfficeIMO.Pdf.PdfRedactionVerificationOptions requiredposition: 1