WriteCharEntity Method
Collapse the table of content
Expand the table of content

XmlWriter.WriteCharEntity Method (Char)

 

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
)

Parameters

ch
Type: System.Char

The Unicode character for which to generate a character entity.

Exception Condition
ArgumentException

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

InvalidOperationException

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 4.5
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show:
© 2016 Microsoft