LexicalPreservationConfig PreserveComments Property XML Compare .NET API Documentation
XML Compare .NET API Documentation - DEPRECATED
Controls whether XML Comments are converted into XML markup.

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

public bool PreserveComments { get; set; }

Property Value

Type: Boolean
Remarks

Controls whether XML Comments are converted into XML markup.

For example, when the preserve parameter is true, with this input:

<!-- add another section here -->
<preserve:comment> add another section here </preserve:comment>
the comment would be converted into:

When the preserve parameter is false, i.e. comments are not converted, it is still possible for the subsequent filters in a filter chain to receive comment events. This depends on whether the subsequent filters have configured the use of a LexicalHandler and/or extend XMLFilterImpl2 or XMLFilterImpl3.

The PreserveProcessingInstructions documentation also describes in which contexts the comment markup appears in the result.

See Also