Assembly: DeltaXML.CoreS9Api (in DeltaXML.CoreS9Api.dll) Version: 10.4.0.1000 (10.4.0.1000)
Property Value
Type: AdvancedEntityRefUsageSpecify advanced behaviour of entity reference processing. In particular, whether a 'compared' encoded entity reference should be replaced by its content, split into an 'old' and 'new' version on detection of change, or left with the full change information. This method is intended for expert use and should typically be left on automatic, as this configures it appropriately for non-specialist use cases (i.e. cases where the input and output preservation setting are consistent). The four modes are interpreted as follows:
- split
encoded entity references have their replacement text removed and are split into 'new' and 'old' versions on detection of change. - replace
encoded entity references are converted to their replacement text values. - change
encoded entity references are left encoded (i.e. skipped over). - auto
if encoded entity references exist then treat as 'split', else treat as 'change'.
Note that entity references are being encoded if, and only if, PreserveEntityReferences returns true. And that the entity replacement text is kept within an encoded entity reference when the PreserveEntityReplacementText method returns true.
Warning: specifying that the encoded entity replacement text should be used, when it does not exist (see note above) will result in neither the entity reference or its replacement text appearing in the output.