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

上一篇：System.Xml.XmlDocument.Load(TextReader) 方法下一篇：System.Xml.XmlDocumentType 类

方法描述

从指定的 XmlReader 加载 XML 文档。

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

public virtual void Load(
	XmlReader reader
)

参数/返回值

参数值/返回值	参数类型/返回类型	参数描述/返回描述
reader	System-Xml-XmlReader	用于将 XML 数据输送到文档中的 XmlReader。
返回值	void

提示和注释

注意

Load 方法总是保留重要的空白。 PreserveWhitespace 属性确定是否保留不重要的空白，即元素内容中的空白。默认值为 false；元素内容中不保留空白。

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

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

如果当前节点及其同辈看起来像下面这样：

复制

onetwo

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

复制

Load 成功，但您将具有不完整的 DOM 树，因为没有根级别元素。在保存文档之前，您必须添加一个根级别元素，否则 Save 将引发异常。

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

如果您希望验证发生，可以使用 XmlReaderSettings 类和 Create 方法创建一个验证用的 XmlReader 实例。有关更多信息，请参见使用 XmlReader 验证 XML 数据。

该方法是文档对象模型 (DOM) 的 Microsoft 扩展。