XMLNode.SelectNodes(String, String, Boolean) 方法

定义

获取一个 XMLNodes 集合,该集合表示与 XPath 参数匹配的所有节点,且以出现在 XMLNode 控件中的顺序为序。

public Microsoft.Office.Interop.Word.XMLNodes SelectNodes (string XPath, string PrefixMapping = "", bool FastSearchSkippingTextNodes = true);
abstract member SelectNodes : string * string * bool -> Microsoft.Office.Interop.Word.XMLNodes
Public Function SelectNodes (XPath As String, Optional PrefixMapping As String = "", Optional FastSearchSkippingTextNodes As Boolean = true) As XMLNodes

参数

XPath
String

有效的 XPath 字符串。

PrefixMapping
String

提供架构中用作搜索依据的前缀。 PrefixMapping如果XPath参数使用名称来搜索元素,请使用 参数。

FastSearchSkippingTextNodes
Boolean

如果为 true,则在搜索指定的节点时,忽略所有文本节点。 如果为 false,则在搜索中包含文本节点。 默认值是 false

返回

XPath 参数匹配的节点,以在 XMLNode 控件中出现的顺序为序。

示例

下面的代码示例使用 SelectNodes 方法获取与给定 XPath 参数匹配的子节点的集合。 然后,该示例显示找到的节点数。 此示例假定当前文档包含一CustomerNode个名为 XMLNode 的 ,其中包含一个匹配的架构元素,该元素包含一个或多个名为 的FirstName子节点。

private void DisplayFirstNameNodesCount()
{
    string element = "/x:Customer/x:FirstName";
    string prefix = "xmlns:x='" + 
        this.CustomerFirstNameNode.NamespaceURI + "'";

    Word.XMLNodes nodes = this.CustomerNode.SelectNodes(element, 
        prefix, true);
    MessageBox.Show(nodes.Count + " element(s) were found.");
}
Private Sub DisplayFirstNameNodesCount()
    Dim element As String = "/x:Customer/x:FirstName"
    Dim prefix As String = "xmlns:x='" & _
        Me.CustomerFirstNameNode.NamespaceURI & "'"

    Dim nodes As Word.XMLNodes = _
        Me.CustomerNode.SelectNodes(element, prefix, True)
    MsgBox(nodes.Count & " element(s) were found.")
End Sub

注解

FastSearchSkippingTextNodes将 参数设置为 false 会降低性能,因为 Microsoft Office Word在文档中的所有节点中搜索该节点中包含的文本。

可选参数

有关可选参数的信息,请参阅 Office 解决方案中的可选参数

适用于