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

定義

命名空間:

Microsoft.Office.Tools.Word

組件:

Microsoft.Office.Tools.Word.v4.0.Utilities.dll

取得 XMLNodes 集合，表示符合 XPath 參數的所有節點，這些節點會以在文件中出現的順序排列。

public Microsoft.Office.Interop.Word.XMLNodes SelectNodes (string xPath, string prefixMapping, bool fastSearchSkippingTextNodes);

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

Public Function SelectNodes (xPath As String, Optional prefixMapping As String, Optional fastSearchSkippingTextNodes As Boolean) As XMLNodes

參數

xPath

String

有效的 XPath 字串。 如需關於 XPath 的詳細資訊，請參閱 XPath 參考。

prefixMapping

String

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

fastSearchSkippingTextNodes

Boolean

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

傳回

XMLNodes

XMLNodes 集合，代表在文件中的顯示順序符合 XPath 參數的所有節點。如果找不到符合 XPath 參數的節點，則為 null。

範例

下列程式代碼範例示範如何在呼叫 SelectNodes 方法時指定 XPath 和 PrefixMapping 參數。 若要使用此範例，請從文件層級專案中的 ThisDocument 類別執行它。

private void DocumentSelectNodes()
{
    if (this.XMLSchemaReferences.Count > 0)
    {
        string XPath = "/x:catalog/x:book/x:title";
        object key = 1;
        string PrefixMapping = "xmlns:x=\"" +
            this.XMLSchemaReferences[key].NamespaceURI +
            "\"";
        Word.XMLNodes nodes = this.SelectNodes(XPath, 
            PrefixMapping, true);
    }
    else
    {
        MessageBox.Show("The document does not contain a " +
            "schema reference.");
    }
}

Private Sub DocumentSelectNodes()
    If Me.XMLSchemaReferences.Count > 0 Then
        Dim XPath As String = "/x:catalog/x:book/x:title"
        Dim PrefixMapping As String = "xmlns:x=""" + _
            Me.XMLSchemaReferences(1).NamespaceURI + """"
        Dim node As Word.XMLNodes = Me.SelectNodes(XPath, _
            PrefixMapping, True)
    Else
        MessageBox.Show("The document does not contain a " + _
            "schema reference.")
    End If
End Sub

備註

FastSearchSkippingTextNodes將 參數設定為 true 會降低效能，因為 Microsoft Office Word 會根據節點中包含的文字搜尋檔中的所有節點。

選擇性參數

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