Export (0) Print
Expand All
Expand Minimize
1 out of 1 rated this helpful - Rate this topic

ConformanceLevel Enumeration

Note: This enumeration is new in the .NET Framework version 2.0.

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)

public enum ConformanceLevel
public enum ConformanceLevel
public enum ConformanceLevel
 Member nameDescription
Supported by the .NET Compact FrameworkAutoThe 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 the .NET Compact FrameworkDocumentThe 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.

Supported by the .NET Compact FrameworkFragmentThe 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).

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.

For more information, see Data Conformance Checking with XmlReader and Data Conformance and the XmlWriter.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0

.NET Compact Framework

Supported in: 2.0
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.