System.Xml.XmlNode.SelectSingleNode 方法 (String)

方法描述

选择匹配 XPath 表达式的第一个 XmlNode。

语法定义(C# System.Xml.XmlNode.SelectSingleNode 方法 (String) 的用法)

public XmlNode SelectSingleNode(
	string xpath
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
xpath System-String XPath 表达式。
返回值 System.Xml.XmlNode 与 XPath 查询匹配的第一个 XmlNode;如果未找到任何匹配节点,则为 null。 不应该要求将 XmlNode“实时”连接到 XML 文档。 也就是说,XML 文档中的更改不会出现在 XmlNode 中,反之亦然。

提示和注释

如果 XPath 表达式需要命名空间解析,必须使用接受 XmlNamespaceManager 作为参数的 SelectSingleNode 重载。 XmlNamespaceManager 用于解析命名空间。

注意

如果 XPath 表达式不包含前缀,则假定命名空间 URI 为空命名空间。 如果 XML 包含默认命名空间,则您仍必须使用 XmlNamespaceManager 并向其添加前缀和命名空间 URI;否则将得不到选定的节点。 有关更多信息,请参见 使用 XPath 导航选择节点。

注意

使用公式表示 XPath 表达式时的一个常见问题是如何在表达式中包含单引号 (') 或双引号 (")。 如果确实要搜索包含单引号的值,则必须用双引号将该字符串括起来。 如果需要搜索包含双引号的值,则必须用单引号将该字符串括起来。

例如,假设您有以下 XML:

复制

'Emma'

下面的 Visual Basic 代码选择一个包含单引号的元素:

复制

book = root.SelectSingleNode("descendant::book[title=""'Emma'""]")

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

System.Xml.XmlNode.SelectSingleNode 方法 (String)例子

该示例使用文件 booksort.xml 作为输入。




  
    Pride And Prejudice
    
      Jane
      Austen
    
    24.95
  
  
    The Handmaid's Tale
    
      Margaret
      Atwood
    
    29.95
  
  
    Emma
    
      Jane
      Austen
    
    19.95
  
  
    Sense and Sensibility
    
      Jane
      Austen
    
    19.95
  

异常

异常 异常描述
XPathException XPath 表达式包含前缀。

命名空间

namespace: System.Xml

程序集: System.Xml(在 System.Xml.dll 中)

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。