XmlReaderSettings.CheckCharacters Property

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Gets or sets a value indicating whether to do character checking.

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

Syntax

'Declaration
Public Property CheckCharacters As Boolean
public bool CheckCharacters { get; set; }

Property Value

Type: System.Boolean
true to do character checking; otherwise false. The default is true.

NoteNote:

If the XmlReader is processing text data, it always checks that the XML names and text content are valid, regardless of the property setting. Setting CheckCharacters to false turns off character checking for character entity references.

Remarks

Instructs the reader to check characters and throw an exception if any characters are outside the range of legal XML characters. Character checking includes checking for illegal characters in the document, as well as checking the validity of XML names (for example, an XML name may not start with a numeral).

For more information, see sections 2.2 (http://www.w3.org/TR/REC-xml\#charsets) and 2.3 (http://www.w3.org/TR/REC-xml\#NT-Name) of the W3C XML 1.0 recommendation.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.