通过

XMLNode.SelectSingleNode 方法

  • 项目

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

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

语法

声明
Function SelectSingleNode ( _
    XPath As String, _
    PrefixMapping As String, _
    FastSearchSkippingTextNodes As Boolean _
) As XMLNode

XMLNode SelectSingleNode(
    string XPath,
    string PrefixMapping,
    bool FastSearchSkippingTextNodes
)

参数

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

返回值

类型：Microsoft.Office.Interop.Word.XMLNode
Microsoft.Office.Tools.Word.XMLNode 控件中与 XPath 参数匹配的第一个子节点。

备注

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

可选参数

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

示例

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

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

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

.NET Framework 安全性

请参见

参考

XMLNode 接口

Microsoft.Office.Tools.Word 命名空间