通过

XMLNode.SelectNodes 方法

  • 项目

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

命名空间：  Microsoft.Office.Tools.Word
程序集：  Microsoft.Office.Tools.Word（在 Microsoft.Office.Tools.Word.dll 中）

语法

声明
Function SelectNodes ( _
    XPath As String, _
    PrefixMapping As String, _
    FastSearchSkippingTextNodes As Boolean _
) As XMLNodes

XMLNodes SelectNodes(
    string XPath,
    string PrefixMapping,
    bool FastSearchSkippingTextNodes
)

参数

  • XPath
    类型：System.String
    一个有效的 XPath 字符串。
  • PrefixMapping
    类型：System.String
    提供架构中用作搜索依据的前缀。如果 XPath 参数使用名称搜索元素，请使用 PrefixMapping 参数。
  • FastSearchSkippingTextNodes
    类型：System.Boolean
    如果为 true，则在搜索指定的节点时，忽略所有文本节点。如果为 false，则在搜索中包含文本节点。默认值为 false。

返回值

类型：Microsoft.Office.Interop.Word.XMLNodes
与 XPath 参数匹配的节点，以在 Microsoft.Office.Tools.Word.XMLNode 控件中出现的顺序为序。

备注

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

可选参数

有关可选参数的信息，请参见Office 解决方案中的可选参数。

示例

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

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

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.");
}

.NET Framework 安全性

请参见

参考

XMLNode 接口

Microsoft.Office.Tools.Word 命名空间