LexicalPreservationConfig PreserveEntityReplacementText Property XML Compare .NET API Documentation
XML Compare .NET API Documentation - DEPRECATED
Controls whether entity replacement text is preserved by this filter.

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

public bool PreserveEntityReplacementText { get; set; }

Property Value

Type: Boolean
Remarks

Controls 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 &amp; seek</para>

This following table documents the effects of the preservation settings for entity replacement text and also entity references:

setPreserveEntityReplacementTextsetPreserveEntityReferencesresult
truetrue<para>Hide <er:amp>&</er:amp> seek</para>
truefalse<para>Hide & seek</para>
falsetrue<para>Hide <er:amp></er:amp> seek</para>
falsefalse<para>Hide seek</para>

The entity replacement text for the &amp; 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 &amp; or a character reference &#x26; so that the pipeline result is well-formed.

See also: OnlineW3C XML 1.0 Specification (Fifth Edition), Section 4.5: Construction of Entity Replacement Text

See Also