Freigeben über


XMLNode.SelectSingleNode-Methode

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

Namespace:  Microsoft.Office.Tools.Word
Assembly:  Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Syntax

'Declaration
Function SelectSingleNode ( _
    XPath As String, _
    PrefixMapping As String, _
    FastSearchSkippingTextNodes As Boolean _
) As XMLNode
XMLNode SelectSingleNode(
    string XPath,
    string PrefixMapping,
    bool FastSearchSkippingTextNodes
)

Parameter

  • PrefixMapping
    Typ: System.String
    Stellt das Präfix im Schema bereit, das bei der Suche verwendet wird.Verwenden Sie den PrefixMapping-Parameter, wenn der XPath-Parameter für die Suche nach Elementen Namen verwendet.
  • FastSearchSkippingTextNodes
    Typ: System.Boolean
    true, wenn bei der Suche nach dem angegebenen Knoten alle Textknoten übersprungen werden sollen.false, um Textknoten in die Suche einzubeziehen.Der Standardwert lautet true.

Rückgabewert

Typ: Microsoft.Office.Interop.Word.XMLNode
Der erste untergeordnete Knoten, der mit dem XPath-Parameter im Microsoft.Office.Tools.Word.XMLNode-Steuerelement übereinstimmt.

Hinweise

Wenn der FastSearchSkippingTextNodes-Parameter auf false festgelegt ist, wird die Leistung herabgesetzt, da Microsoft Office Word alle Knoten in einem Dokument auf den im Knoten enthaltenen Text durchsucht.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird mithilfe der SelectSingleNode-Methode ein untergeordneter Knoten abgerufen, der mit dem gegebenen XPath-Parameter übereinstimmt. Anschließend wird der Name des gefundenen Knotens angezeigt. In diesem Beispiel wird davon ausgegangen, dass das aktuelle Dokument einen XMLNode mit dem Namen CustomerNode mit einem übereinstimmenden Schemaelement enthält, der über einen oder mehrere untergeordnete Knoten mit dem Namen LastName verfügt.

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

.NET Framework-Sicherheit

Siehe auch

Referenz

XMLNode Schnittstelle

Microsoft.Office.Tools.Word-Namespace