LexicalPreservationConfig AdvancedEntityReferenceUsage Property XML Compare .NET API Documentation
XML Compare .NET API Documentation - DEPRECATED
Specify advanced behaviour of entity reference processing.

Namespace: DeltaXML.CoreS9Api.Config
Assembly: DeltaXML.CoreS9Api (in DeltaXML.CoreS9Api.dll) Version: 10.4.0.1000 (10.4.0.1000)
Syntax

public AdvancedEntityRefUsage AdvancedEntityReferenceUsage { get; set; }

Property Value

Type: AdvancedEntityRefUsage
Remarks

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

See Also