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

定义

命名空间:

Microsoft.Office.Tools.Word

程序集:

Microsoft.Office.Tools.Word.dll

获取一个 XMLNode 对象，该对象表示 XMLNode 控件中与 XPath 参数匹配的第一个子节点。

public Microsoft.Office.Interop.Word.XMLNode SelectSingleNode (string XPath, string PrefixMapping = "", bool FastSearchSkippingTextNodes = true);

abstract member SelectSingleNode : string * string * bool -> Microsoft.Office.Interop.Word.XMLNode

Public Function SelectSingleNode (XPath As String, Optional PrefixMapping As String = "", Optional FastSearchSkippingTextNodes As Boolean = true) As XMLNode

参数

XPath

String

有效的 XPath 字符串。

PrefixMapping

String

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

FastSearchSkippingTextNodes

Boolean

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

返回

XMLNode

XMLNode 控件中与 XPath 参数匹配的第一个子节点。

示例

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

private void FindLastNameNode()
{
    string element = "/x:Customer/x:LastName";
    string prefix = "xmlns:x='" + 
        this.CustomerLastNameNode.NamespaceURI + "'";

    Word.XMLNode node = this.CustomerNode.SelectSingleNode(element,
        prefix, true);
    if (node != null)
    {
        MessageBox.Show(node.BaseName + " element was found.");
    }
    else
    {
        MessageBox.Show("The requested node was not found.");
    }
}

Private Sub FindLastNameNode()
    Dim element As String = "/x:Customer/x:LastName"
    Dim prefix As String = "xmlns:x='" & _
        Me.CustomerLastNameNode.NamespaceURI & "'"

    Dim node As Word.XMLNode = _
        Me.CustomerNode.SelectSingleNode(element, prefix, True)
    If node IsNot Nothing Then
        MsgBox(node.BaseName & " element was found.")
    Else
        MsgBox("The requested node was not found.")
    End If
End Sub

注解

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

可选参数

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