共用方式為


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 參數的第一個子節點。

備註

因為 Microsoft Office Word 會在文件的所有節點中搜尋包含在節點內的文字,所以將 FastSearchSkippingTextNodes 參數設定為 false 會減低效能。

選擇性參數

如需選擇性參數的詳細資訊,請參閱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 命名空間