XdmSerializationSettings.CharacterMapping PropertyXdmSerializationSettings.CharacterMapping PropertyXdmSerializationSettings::CharacterMapping Property

Gets or sets a mapping of characters to string values.

Syntax

Public Property CharacterMapping As CharacterMappingDictionary
        Get
        Set(ByVal value As CharacterMappingDictionary)
public CharacterMappingDictionary CharacterMapping { get; set; }
public:
property CharacterMappingDictionary^ CharacterMapping {
    CharacterMappingDictionary^ get();
    void set(CharacterMappingDictionary^ value);
}
 

Exceptions

ExceptionCondition
ArgumentNullExceptionArgumentNullExceptionArgumentNullExceptionAn attempt was made to set CharacterMappingCharacterMappingCharacterMapping to null a null reference (Nothing in Visual Basic) nullptr.

Remarks

This property corresponds to the use-character-maps serialization parameter. Character maps allow a specific character appearing in a text or attribute node in the instance of the data model to be replaced with a specified string of characters during serialization. The string that is substituted is output "as is," and the serializer performs no checks that the resulting document is well-formed. This mechanism can therefore be used to introduce arbitrary markup in the serialized output. See Section 20.1 Character MapsXT of [XSL Transformations (XSLT) Version 2.0] for examples of using character mapping in XSLT.