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

定義

命名空間:

Microsoft.Office.Tools.Word

組件:

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

傳回 XMLNode 物件，表示在文件中第一個符合 XPath 參數的節點。

public Microsoft.Office.Interop.Word.XMLNode SelectSingleNode (string xPath, string prefixMapping, bool fastSearchSkippingTextNodes);

member this.SelectSingleNode : string * string * bool -> Microsoft.Office.Interop.Word.XMLNode

Public Function SelectSingleNode (xPath As String, Optional prefixMapping As String, Optional fastSearchSkippingTextNodes As Boolean) As XMLNode

參數

xPath

String

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

prefixMapping

String

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

fastSearchSkippingTextNodes

Boolean

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

傳回

XMLNode

XMLNode 物件，代表文件中符合 XPath 參數的第一個節點。如果找不到符合 XPath 參數的節點，則為 null。

範例

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

private void DocumentSelectSingleNode()
{
    if (this.XMLSchemaReferences.Count > 0)
    {
        string XPath = "/x:catalog/x:book/x:title";
        object key = 1;

        string PrefixMapping = "xmlns:x=\"" +
            this.XMLSchemaReferences.get_Item(ref key).NamespaceURI +
            "\"";

        Word.XMLNode node = this.SelectSingleNode(XPath, 
            PrefixMapping, true);
    }
    else
    {
        MessageBox.Show("The document does not contain a " +
            "schema reference.");
    }
}

Private Sub DocumentSelectSingleNode()
    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.XMLNode = Me.SelectSingleNode(XPath, _
            PrefixMapping, True)
    Else
        MessageBox.Show("The document does not contain a " + _
            "schema reference.")
    End If
End Sub

備註

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

選擇性參數

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