XmlDataDocument 类

System.Xml.XmlDataDocument.Load 方法 (XmlReader)

上一篇：System.Xml.XmlDataDocument.Load(TextReader) 方法下一篇：System.Xml.XmlDataDocument.LoadXml 方法

方法描述

从指定的 XmlReader 加载 XmlDataDocument。

语法定义(C# System.Xml.XmlDataDocument.Load 方法 (XmlReader) 的用法)

public override void Load(
	XmlReader reader
)

参数/返回值

参数值/返回值	参数类型/返回类型	参数描述/返回描述
reader	System-Xml-XmlReader	包含要加载的 XML 文档的 XmlReader。
返回值	void

提示和注释

XmlDataDocument 不支持创建实体引用。如果数据源包含实体引用，则必须创建 XmlValidatingReader，同时将 EntityHandling 属性设置为 EntityHandling.ExpandEntities（这是默认的行为），并将 XmlValidatingReader 传递给 Load 方法。如果不使用 XmlValidatingReader，则 Load 方法引发一个异常。

Load 方法总是保留重要的空白。 PreserveWhitespace 属性确定是否保留空白。默认值为 false，不保留空白。

如果读取器处于初始状态（即 ReadState=ReadState.Initial），则 Load 使用读取器的全部内容并从它找到的内容生成 DOM。

如果读取器已经定位在深度为“n”的某个节点上，则此方法加载该节点及其后续所有同辈节点，直到关闭深度“n”的结束标记。这具有下列结果。

如果当前节点及其同级看起来类似于下面这样：

复制

onetwo

Load 引发异常，原因是一个文档不能有两个根级别元素。如果当前节点及其同级看起来类似于下面这样：

复制

instruction?>

Load 将会成功，但是由于缺少根级别元素，您将得到不完整的 DOM 树。您必须在保存文档之前添加根级别元素；否则 Save 方法将引发异常。

如果读取器定位于对于文档的根级别来说无效的叶节点（如空白或特性节点），则读取器将继续读取，直到定位在可用于根的节点上。文档在此位置开始加载。