System.Xml.XmlWriter.WriteCharEntity Method

When overridden in a derived class, forces the generation of a character entity for the specified Unicode character value.

Syntax

public abstract void WriteCharEntity (char ch)

Parameters

ch
The Unicode character for which to generate a character entity.

Exceptions

TypeReason
ArgumentExceptionThe character is in the surrogate pair character range, 0xd800 - 0xdfff, or the text would result in a non-well formed XML document.
InvalidOperationExceptionThe XmlWriter.WriteState is WriteState.Closed.

Remarks

This method writes the Unicode character in hexadecimal character entity reference format.

For the asynchronous version of this method, see XmlWriter.WriteCharEntityAsync(char).

Requirements

Namespace: System.Xml
Assembly: System.Xml (in System.Xml.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0, 4.0.0.0