XMLNode.SelectNodes-Methode

Artikel
01/03/2014

Ruft eine Microsoft.Office.Interop.Word.XMLNodes-Auflistung ab, die alle mit dem XPath-Parameter übereinstimmenden Knoten in der Reihenfolge darstellt, in der sie im Microsoft.Office.Tools.Word.XMLNode-Steuerelement angeordnet sind.

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

Syntax

'Declaration
Function SelectNodes ( _
    XPath As String, _
    PrefixMapping As String, _
    FastSearchSkippingTextNodes As Boolean _
) As XMLNodes

XMLNodes SelectNodes(
    string XPath,
    string PrefixMapping,
    bool FastSearchSkippingTextNodes
)

Parameter

XPath
Typ: System.String
Eine gültige XPath-Zeichenfolge.

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

Rückgabewert

Typ: Microsoft.Office.Interop.Word.XMLNodes
Die mit dem XPath-Parameter übereinstimmenden Knoten in der Reihenfolge, in der sie im Microsoft.Office.Tools.Word.XMLNode-Steuerelement angeordnet sind.

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 SelectNodes-Methode eine Auflistung der untergeordneten Knoten abgerufen, die mit dem gegebenen XPath-Parameter übereinstimmen. Anschließend wird die Anzahl der gefundenen Knoten 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 FirstName verfügt.

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

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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

XMLNode Schnittstelle

Microsoft.Office.Tools.Word-Namespace

Freigeben über