Preservation

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

For example, GemBox.Document doesn't support SmartArts and Equations through its API.

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 PreserveUnsupportedFeatures property when loading a document with DocumentModel.Load(String, LoadOptions) static methods.

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

Note

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

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

• C#
• VB.NET

// 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.