XPathDocument 构造函数

定义

命名空间:

System.Xml.XPath

程序集:

System.Xml.XPath.dll

初始化 XPathDocument 类的新实例。

重载

XPathDocument(Stream)	使用指定的 XPathDocument 对象中的 XML 数据对 Stream 类的新实例进行初始化。
XPathDocument(String)	使用指定文件中的 XML 数据对 XPathDocument 类的新实例进行初始化。
XPathDocument(XmlReader)	使用指定的 XPathDocument 对象中包含的 XML 数据对 XmlReader 类的新实例进行初始化。
XPathDocument(TextReader)	使用指定的 XPathDocument 对象中包含的 XML 数据对 TextReader 类的新实例进行初始化。
XPathDocument(String, XmlSpace)	使用指定文件中的 XML 数据对 XPathDocument 类的新实例进行实例化，并采用指定的空白处理方法。
XPathDocument(XmlReader, XmlSpace)	使用指定的 XPathDocument 对象中包含的 XML 数据对 XmlReader 类的新实例进行初始化，并采用指定的空白处理方法。

XPathDocument(Stream)

Source:

XPathDocument.cs

使用指定的 XPathDocument 对象中的 XML 数据对 Stream 类的新实例进行初始化。

public:
 XPathDocument(System::IO::Stream ^ stream);

public XPathDocument (System.IO.Stream stream);

new System.Xml.XPath.XPathDocument : System.IO.Stream -> System.Xml.XPath.XPathDocument

Public Sub New (stream As Stream)

参数

stream

Stream

包含 XML 数据的 Stream 对象。

例外

XmlException

XML 数据中出现错误。 XPathDocument 保持为空。

ArgumentNullException

作为参数传递的 Stream 对象为 null。

XPathDocument(String)

Source:

XPathDocument.cs

使用指定文件中的 XML 数据对 XPathDocument 类的新实例进行初始化。

public:
 XPathDocument(System::String ^ uri);

public XPathDocument (string uri);

new System.Xml.XPath.XPathDocument : string -> System.Xml.XPath.XPathDocument

Public Sub New (uri As String)

参数

uri

String

包含 XML 数据的文件的路径。

例外

XmlException

XML 数据中出现错误。 XPathDocument 保持为空。

ArgumentNullException

文件路径参数为 null。

注解

若要保留空白，请使用 XPathDocument 接受 对象作为参数的 XmlSpace 构造函数。

XPathDocument(XmlReader)

Source:

XPathDocument.cs

使用指定的 XPathDocument 对象中包含的 XML 数据对 XmlReader 类的新实例进行初始化。

public:
 XPathDocument(System::Xml::XmlReader ^ reader);

public XPathDocument (System.Xml.XmlReader reader);

new System.Xml.XPath.XPathDocument : System.Xml.XmlReader -> System.Xml.XPath.XPathDocument

Public Sub New (reader As XmlReader)

参数

reader

XmlReader

包含 XML 数据的 XmlReader 对象。

例外

XmlException

XML 数据中出现错误。 XPathDocument 保持为空。

ArgumentNullException

作为参数传递的 XmlReader 对象为 null。

注解

XmlReader对象可用于将整个 XML 文档或部分 XML 文档加载到 中XPathDocument。 若要将 XML 文档的一部分加载到 中 XPathDocument，请将 XmlReader 对象置于要从中加载数据的顶部 XML 节点上。 使用 XPathDocument 构造函数创建 XPathDocument 时，数据将从当前顶部节点加载到其所有同级节点。 之后，将 XmlReader 定位在顶部 XML 节点的外部范围。 或者，可以使用 ReadSubtree 方法将 加载 XPathDocument 到 XML 文档中的特定元素中。

下面是使用 XPathDocument 构造函数时要考虑的重要说明。

• XmlReader具有相应关联XmlResolver对象设置的对象可用于解析 XML 数据中的实体或其他引用。

• XmlReader如果对象位于对文档的根级别无效的叶节点上（例如，空白或属性节点），则XmlReader对象将继续读取，直到它位于可用于根的节点上。 XPathDocument此时开始加载 。

• 若要保留空白，请使用 XPathDocument 接受 对象作为参数的 XmlSpace 构造函数。

XPathDocument(TextReader)

Source:

XPathDocument.cs

使用指定的 XPathDocument 对象中包含的 XML 数据对 TextReader 类的新实例进行初始化。

public:
 XPathDocument(System::IO::TextReader ^ textReader);

public XPathDocument (System.IO.TextReader textReader);

new System.Xml.XPath.XPathDocument : System.IO.TextReader -> System.Xml.XPath.XPathDocument

Public Sub New (textReader As TextReader)

参数

textReader

TextReader

包含 XML 数据的 TextReader 对象。

例外

XmlException

XML 数据中出现错误。 XPathDocument 保持为空。

ArgumentNullException

作为参数传递的 TextReader 对象为 null。

注解

使用 TextReader 对象加载 XML 数据后，对象的光标 TextReader 将定位在数据的末尾。 TextReader必须重置 对象才能再次读取数据。

XPathDocument(String, XmlSpace)

Source:

XPathDocument.cs

使用指定文件中的 XML 数据对 XPathDocument 类的新实例进行实例化，并采用指定的空白处理方法。

public:
 XPathDocument(System::String ^ uri, System::Xml::XmlSpace space);

public XPathDocument (string uri, System.Xml.XmlSpace space);

new System.Xml.XPath.XPathDocument : string * System.Xml.XmlSpace -> System.Xml.XPath.XPathDocument

Public Sub New (uri As String, space As XmlSpace)

参数

uri

String

包含 XML 数据的文件的路径。

space

XmlSpace

一个 XmlSpace 对象。

例外

XmlException

XML 数据中出现错误。 XPathDocument 保持为空。

ArgumentNullException

文件路径参数或 XmlSpace 对象参数为 null。

注解

• XmlSpace作为参数传递的对象指定是否保留空白。 Default 仅保留大量空白; Preserve 保留所有空白。 默认情况下， XmlSpace 对象设置为 Default。

• 构造函数的功能 XPathDocument 与构造函数的功能相同 XPathDocument ，所描述的空白处理选项除外。

另请参阅

• XmlSpace

XPathDocument(XmlReader, XmlSpace)

Source:

XPathDocument.cs

使用指定的 XPathDocument 对象中包含的 XML 数据对 XmlReader 类的新实例进行初始化，并采用指定的空白处理方法。

public:
 XPathDocument(System::Xml::XmlReader ^ reader, System::Xml::XmlSpace space);

public XPathDocument (System.Xml.XmlReader reader, System.Xml.XmlSpace space);

new System.Xml.XPath.XPathDocument : System.Xml.XmlReader * System.Xml.XmlSpace -> System.Xml.XPath.XPathDocument

Public Sub New (reader As XmlReader, space As XmlSpace)

参数

reader

XmlReader

包含 XML 数据的 XmlReader 对象。

space

XmlSpace

一个 XmlSpace 对象。

例外

XmlException

XML 数据中出现错误。 XPathDocument 保持为空。

ArgumentNullException

XmlReader 对象参数或 XmlSpace 对象参数为 null。

注解

• XmlSpace作为参数传递的对象指定是否保留空白。 Default 仅保留大量空白; Preserve 保留所有空白。 默认情况下， XmlSpace 对象设置为 Default。

• 构造函数的功能 XPathDocument 与构造函数的功能相同 XPathDocument ，所描述的空白处理选项除外。

另请参阅

• XmlSpace