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

定义

命名空间:

Microsoft.Office.Tools.Word

程序集:

Microsoft.Office.Tools.Word.dll

获取一个 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。

返回

XMLNodes

与 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 解决方案中的可选参数。