XMLNode.SelectSingleNode(String, String, Boolean) Methode

Referenz

Definition

Namespace:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft ein XMLNode-Objekt ab, das den ersten untergeordneten Knoten darstellt, der mit dem XPath-Parameter im XMLNode-Steuerelement übereinstimmt.

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

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

Public Function SelectSingleNode (XPath As String, Optional PrefixMapping As String = "", Optional FastSearchSkippingTextNodes As Boolean = true) As XMLNode

Parameter

XPath: String

Eine gültige XPath-Zeichenfolge.

PrefixMapping: String

Stellt das Präfix im Schema bereit, das bei der Suche verwendet wird. Verwenden Sie den PrefixMapping Parameter, wenn Ihr XPath Parameter Namen verwendet, um nach Elementen zu suchen.

FastSearchSkippingTextNodes: Boolean

true, wenn bei der Suche nach dem angegebenen Knoten alle Textknoten übersprungen werden sollen. false, um Textknoten in die Suche einzubeziehen. Der Standardwert ist truesein.

Gibt zurück

XMLNode

Der erste untergeordnete Knoten, der mit dem XPath-Parameter im XMLNode-Steuerelement übereinstimmt.

Beispiele

Im folgenden Codebeispiel wird die SelectSingleNode -Methode verwendet, um einen untergeordneten Knoten abzurufen, der dem angegebenen XPath Parameter entspricht. Im Beispiel wird dann der Name des gefundenen Knotens angezeigt. In diesem Beispiel wird davon ausgegangen, dass das aktuelle Dokument einen XMLNode benannten CustomerNode mit einem übereinstimmenden Schemaelement enthält, das mindestens einen untergeordneten Knoten mit dem Namen LastNameenthält.

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

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

Hinweise

Das Festlegen des FastSearchSkippingTextNodes Parameters auf verringert false die Leistung, da Microsoft Office Word alle Knoten in einem Dokument nach dem im Knoten enthaltenen Text durchsucht.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Projektmappen.

Gilt für:

Freigeben über