Assembly: DeltaXML.CoreS9Api (in DeltaXML.CoreS9Api.dll) Version: 10.4.0.1000 (10.4.0.1000)
Property Value
Type: BooleanControls whether entity replacement text is preserved by this filter.
As well as being able to use an element to describe the details of an element reference it is also possible to control whether the replacement text is preserved in the output.
The term 'Entity Replacement Text' is used in the W3C XML Specification and section 4.5 describes the process of replacing entity references.
For the follow example input markup:
<para>Hide & seek</para>
This following table documents the effects of the preservation settings for entity replacement text and also entity references:
setPreserveEntityReplacementText | setPreserveEntityReferences | result |
---|---|---|
true | true | <para>Hide <er:amp>&</er:amp> seek</para> |
true | false | <para>Hide & seek</para> |
false | true | <para>Hide <er:amp></er:amp> seek</para> |
false | false | <para>Hide seek</para> |
The entity replacement text for the & entity is the unicode ampersand character (U+0026) and this character appears in the results generated by this filter. An output filter or serializer at the end of a pipeline may subsequently re-serialize this character back into an entity reference such as & or a character reference & so that the pipeline result is well-formed.
See also: W3C XML 1.0 Specification
(Fifth Edition), Section 4.5: Construction of Entity Replacement Text