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

定義

命名空間:

Microsoft.Office.Tools.Word

組件:

Microsoft.Office.Tools.Word.dll

取得 XMLNodes 集合，表示符合 XPath 參數的節點，並且是 XMLNode 控制項中出現的排列順序。

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

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

Public Function SelectNodes (XPath As String, Optional PrefixMapping As String = "", Optional FastSearchSkippingTextNodes As Boolean = true) As XMLNodes

參數

XPath

String

有效的 XPath 字串。

PrefixMapping

String

提供要在結構描述中執行搜尋的前置詞。 PrefixMapping如果您的XPath參數使用名稱來搜尋元素，請使用 參數。

FastSearchSkippingTextNodes

Boolean

true 表示在搜尋指定節點時，要略過所有文字節點。 false 則表示要在搜尋中包含文字節點。 預設值為 false。

傳回

XMLNodes

符合 XPath 參數的節點以在 XMLNode 控制項中出現的順序排列。

範例

下列程式代碼範例會 SelectNodes 使用 方法來取得符合指定 XPath 參數的子節點集合。 然後，此範例會顯示找到的節點數目。 本範例假設目前的檔包含具有 XMLNode 相符架構專案的具名 CustomerNode ，其中包含一或多個名為 FirstName的子節點。

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

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

備註

FastSearchSkippingTextNodes將 參數設定為 false 會降低效能，因為 Microsoft Office Word 會在檔中搜尋檔內含的文字。

選擇性參數

如需選擇性參數的資訊，請參閱 Office 方案中的選擇性參數。