Click or drag to resize
Preservation

GemBox.Document supports most of the Microsoft Word document features through its API, but not all.

For example, GemBox.Document doesn't support document revision changes, comments, footnotes and endnotes through its API.

Note Note

Unsupported features will be incrementally added to the future versions of GemBox.Document, based on customer feedback.

Although not supporting all Microsoft Word document features through its API, GemBox.Document allows you to preserve the unsupported features, so you don't lose any relevant document content when loading and saving a document.

Activate / deactivate preservation

Preservation of the unsupported features is managed through LoadOptionsPreserveUnsupportedFeatures property when loading a document with DocumentModelLoad static methods.

Setting the LoadOptionsPreserveUnsupportedFeatures property to false will deactivate preservation. By default, preservation is activated.

Note Note

Default DOCX load options returned from LoadOptionsDocxDefault static property has preservation activated.

The following example shows how to load a DOCX document with and without activated preservation:

// Preserve unsupported features while loading.
var docPreserved = DocumentModel.Load("Document.docx", LoadOptions.DocxDefault);

// Do not preserve unsupported features while loading.
var docUnpreserved = DocumentModel.Load("Document.docx", new DocxLoadOptions() { PreserveUnsupportedFeatures = false });
PreservedInline element

PreservedInline element is a special element that may be contained in a document only if a document is loaded with activated preservation.

PreservedInline element does not have a public constructor nor any public property; its only purpose is to keep internal data about a document content element which was read from the loaded file but is not directly supported through GemBox.Document API.