XmlWriter.WriteCharEntity Method (Char)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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

Namespace:   System.Xml
Assembly:  System.Xml (in System.Xml.dll)

public abstract void WriteCharEntity(
	char ch


Type: System.Char

The Unicode character for which to generate a character entity.

Exception Condition

The character is in the surrogate pair character range, 0xd800 - 0xdfff.


An XmlWriter method was called before a previous asynchronous operation finished. In this case, InvalidOperationException is thrown with the message “An asynchronous operation is already in progress.”

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

For the asynchronous version of this method, see WriteCharEntityAsync.

See XmlTextWriter.WriteCharEntity for an example using this method.

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top