ConformanceLevel 枚举

定义

指定 XmlReaderXmlWriter 对象执行的输入或输出检查的量。

public enum class ConformanceLevel
public enum ConformanceLevel
type ConformanceLevel = 
Public Enum ConformanceLevel
继承
ConformanceLevel

字段

Auto 0

XmlReaderXmlWriter 对象自动检测是否应该执行文档级别或片段级别检查,并执行相应的检查。 如果你正在包装另一个 XmlReaderXmlWriter 对象,外层对象不进行任何附加一致性检查。 一致性检查只针对基础对象。

有关如何确定符合性级别,请参见 ConformanceLevelConformanceLevel 属性详细信息。

Document 2

按 W3C 定义,XML 数据符合格式良好的 XML 1.0 document。 此级别的检查确保所读写的流可由任何充当 XML 1.0 文档的处理器使用。

Fragment 1

按 W3C 定义,XML 数据是格式良好的 XML 片段。 此符合性级别表示可能没有根元素但其他方面格式标准的 XML 文档。 此级别的检查确保所读写的流可由任何充当 XML 1.0 外部已分析实体的处理器使用。

注解

创建 XML 读取器或编写器实例时,可以使用 XmlReaderSettingsXmlWriterSettings 类指定希望新实例支持的功能。 可以配置的功能之一是要对 XML 数据强制实施的一致性级别。

创建合规的读取器或编写器可以保证所处理的 XML 数据符合指定的一致性级别。 如果正在读取或写入的流不符合符合性级别,则会引发异常。

使用 ConformanceLevel.Document 枚举成员进行文档级检查 (成员) ConformanceLevel.Fragment 强制实施片段级检查,并确保以下各项:

  • 顶级项除了 XML 声明、DTD、元素、注释、空格或处理指令外,没有任何节点。

  • XML 数据有一个且只有一个顶级元素节点。

适用于

另请参阅