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

定义

命名空间:

Microsoft.Office.Tools.Word

程序集:

Microsoft.Office.Tools.Word.v4.0.Utilities.dll

获取一个 XMLNodes 集合，该集合表示按照节点在文档中出现的顺序与 XPath 参数匹配的所有节点。

public Microsoft.Office.Interop.Word.XMLNodes SelectNodes (string xPath, string prefixMapping, bool fastSearchSkippingTextNodes);

member this.SelectNodes : string * string * bool -> Microsoft.Office.Interop.Word.XMLNodes

Public Function SelectNodes (xPath As String, Optional prefixMapping As String, Optional fastSearchSkippingTextNodes As Boolean) As XMLNodes

参数

xPath

String

有效的 XPath 字符串。 关于 XPath 的更多信息，请参见 XPath 参考。

prefixMapping

String

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

fastSearchSkippingTextNodes

Boolean

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

返回

XMLNodes

一个 XMLNodes 集合，该集合表示按照节点在文档中出现的顺序与 XPath 参数匹配的所有节点；如果未找到与 XPath 参数匹配的节点，则为 null。

示例

下面的代码示例演示如何在调用 SelectNodes 方法时指定 XPath 和 PrefixMapping 参数。 若要使用此示例，请从文档级项目中的 ThisDocument 类运行它。

private void DocumentSelectNodes()
{
    if (this.XMLSchemaReferences.Count > 0)
    {
        string XPath = "/x:catalog/x:book/x:title";
        object key = 1;
        string PrefixMapping = "xmlns:x=\"" +
            this.XMLSchemaReferences[key].NamespaceURI +
            "\"";
        Word.XMLNodes nodes = this.SelectNodes(XPath, 
            PrefixMapping, true);
    }
    else
    {
        MessageBox.Show("The document does not contain a " +
            "schema reference.");
    }
}

Private Sub DocumentSelectNodes()
    If Me.XMLSchemaReferences.Count > 0 Then
        Dim XPath As String = "/x:catalog/x:book/x:title"
        Dim PrefixMapping As String = "xmlns:x=""" + _
            Me.XMLSchemaReferences(1).NamespaceURI + """"
        Dim node As Word.XMLNodes = Me.SelectNodes(XPath, _
            PrefixMapping, True)
    Else
        MessageBox.Show("The document does not contain a " + _
            "schema reference.")
    End If
End Sub

注解

FastSearchSkippingTextNodes将 参数设置为 true 会降低性能，因为 Microsoft Office Word根据节点中包含的文本搜索文档中的所有节点。

可选参数

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