Skip to main content

Search OfficeIMO

Enter a topic, API type, or PowerShell command.

Documentation Search all OfficeIMO/
Class

WordDocumentComparer

OfficeIMO.Word

Namespace
OfficeIMO.Word
Assembly
OfficeIMO.Word
Source revision
0eef6a5756b9 with working tree changes
Modifiers
static

Provides simple comparison between two Word documents.

Inheritance

  • object
  • WordDocumentComparer

Methods

public static WordDocument Compare(string sourcePath, string targetPath) #

Compares two documents and produces a new document with revision marks.

Parameters

sourcePath string required
Path to the original document.
targetPath string required
Path to the modified document.

Returns

WordDocument Document containing revision marks highlighting differences.
CompareStructure 3 overloads
public static WordComparisonResult CompareStructure(string sourcePath, string targetPath) #

Compares two documents and returns a machine-readable summary of structural differences.

Parameters

sourcePath string required
Path to the original document.
targetPath string required
Path to the modified document.

Returns

WordComparisonResult A deterministic comparison result that can be used for review reports and automation.
public static WordComparisonResult CompareStructure(string sourcePath, string targetPath, WordComparisonOptions? options) #

Compares two documents and returns a machine-readable summary of structural differences.

Parameters

sourcePath string required
Path to the original document.
targetPath string required
Path to the modified document.
options OfficeIMO.Word.WordComparisonOptions? required
Optional comparison switches for text normalization and feature families.

Returns

WordComparisonResult A deterministic comparison result that can be used for review reports and automation.
public static WordComparisonResult CompareStructure(WordDocument source, WordDocument target, WordComparisonOptions? options = null, string sourceLabel = "source", string targetLabel = "target") #

Compares two already-loaded documents without writing them to disk and returns a machine-readable summary.

Parameters

source OfficeIMO.Word.WordDocument required
Original document.
target OfficeIMO.Word.WordDocument required
Modified document.
options OfficeIMO.Word.WordComparisonOptions? = null optional
Optional comparison switches for text normalization and feature families.
sourceLabel string = "source" optional
Logical source label included in reports.
targetLabel string = "target" optional
Logical target label included in reports.

Returns

WordComparisonResult A deterministic comparison result that can be used for review reports and automation.
CreateRedlineDocument 3 overloads
public static WordComparisonResult CreateRedlineDocument(string sourcePath, string targetPath, string outputPath) #

Writes a DOCX redline for two paths using the default comparison and redline settings.

Parameters

sourcePath string required
targetPath string required
outputPath string required
public static WordComparisonResult CreateRedlineDocument(string sourcePath, string targetPath, string outputPath, WordComparisonRedlineOptions? options) #

Compares two documents and writes a DOCX redline document using the configured redline mode.

Parameters

sourcePath string required
Path to the original document.
targetPath string required
Path to the modified document.
outputPath string required
Path where the redline DOCX should be written.
options OfficeIMO.Word.WordComparisonRedlineOptions? required
Optional redline and comparison settings.

Returns

WordComparisonResult The structured comparison result used to generate the redline document.
public static WordComparisonResult CreateRedlineDocument(WordDocument source, WordDocument target, string outputPath, WordComparisonRedlineOptions? options) #

Writes a redline from the current loaded models, including unsaved edits, without saving, reopening or disposing either input.

Parameters

source OfficeIMO.Word.WordDocument required
Caller-owned original document, already authenticated if encrypted.
target OfficeIMO.Word.WordDocument required
Caller-owned modified document, already authenticated if encrypted.
outputPath string required
Destination distinct from either model's associated file.
options OfficeIMO.Word.WordComparisonRedlineOptions? required
Native comparison and redline settings. Null selects defaults; supplied settings are not modified.

Returns

WordComparisonResult The structured comparison used to generate the redline.