Share via

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
)

參數

  • PrefixMapping
    型別：System.String
    提供要在結構描述中執行搜尋的前置詞。如果 XPath 參數是以名稱來搜尋項目，請使用 PrefixMapping 參數。
  • FastSearchSkippingTextNodes
    型別：System.Boolean
    true 表示在搜尋指定節點時，要略過所有文字節點。false 則表示要在搜尋中包含文字節點。預設值為 false。

傳回值

型別：Microsoft.Office.Interop.Word.XMLNodes
符合 XPath 參數的節點以在 Microsoft.Office.Tools.Word.XMLNode 控制項中出現的順序排列。

備註

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

選擇性參數

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