Export (0) Print
Expand All

XmlWriter.WriteCharEntity Method

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

Namespace:  System.Xml
Assemblies:   System.Xml (in System.Xml.dll)
  System.Xml.ReaderWriter (in System.Xml.ReaderWriter.dll)

public abstract void WriteCharEntity(
	char ch
)

Parameters

ch
Type: System.Char

The Unicode character for which to generate a character entity.

ExceptionCondition
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.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone Silverlight 8.1, Windows Phone Silverlight 8

Portable Class Library

Supported in: Portable Class Library
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft