XMLNode.SelectNodes(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 eine XMLNodes-Auflistung ab, die alle mit dem XPath-Parameter übereinstimmenden Knoten in der Reihenfolge darstellt, in der sie im XMLNode-Steuerelement angeordnet sind.

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

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 falsesein.

Gibt zurück

XMLNodes

Die mit dem XPath-Parameter übereinstimmenden Knoten in der Reihenfolge, in der sie im XMLNode-Steuerelement angeordnet sind.

Beispiele

Im folgenden Codebeispiel wird die SelectNodes -Methode verwendet, um eine Auflistung der untergeordneten Knoten abzurufen, die dem angegebenen XPath Parameter entsprechen. Im Beispiel wird dann die Anzahl der gefundenen Knoten 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 namens FirstNameenthält.

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

Hinweise

Das Festlegen des FastSearchSkippingTextNodes Parameters auf false verringert 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