• Article

ConformanceLevel Enumeration

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

Specifies the amount of input or output checking that the created XmlReader and XmlWriter objects perform.

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

Syntax

'Declaration
Public Enumeration ConformanceLevel

public enum ConformanceLevel

Members

Member name Description
Supported by Silverlight for Windows PhoneSupported by Xbox 360 Auto The XmlReader or XmlWriter object automatically detects whether document or fragment checking should be performed, and does the appropriate checking. In the case where you are wrapping another XmlReader or XmlWriter object, the outer object does not do any additional conformance checking. Conformance checking is left up to the underlying object.
Supported by Silverlight for Windows PhoneSupported by Xbox 360 Fragment The XML data is a well-formed XML fragment.

This conformance level represents an XML document which does not necessarily have a root element, but is otherwise well-formed. This level of checking ensures that the stream being read or written can be consumed by any processor as an XML 1.0 external parsed entity (http://www.w3.org/TR/REC-xml#NT-extParsedEnt).
Supported by Silverlight for Windows PhoneSupported by Xbox 360 Document The XML data is in conformance to the rules for a well-formed XML 1.0 document.

This level of checking ensures that the stream being read or written can be consumed by any processor as an XML 1.0 document (http://www.w3.org/TR/REC-xml#NT-document).

In addition to the ConformanceLevel.Fragment checks, the ConformanceLevel.Document level of checks also ensures the following:

  • The top-level item must not have any nodes other than XML Declaration, DTD, element, comment, white space, or processing instruction.

  • The XML data must have one, and only one, top-level element node.

Remarks

When you create a reader or writer instance, you can use the XmlReaderSettings or XmlWriterSettings class to specify the features that you want the new instance to support. One of the features that you can configure is the level of conformance you wish to enforce on the XML data.

Creating a compliant reader or writer guarantees that the XML data being processed complies with the specified conformance level. If the stream being read or written does not comply with the conformance level, an exception is thrown.

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.