DocumentBase.SelectNodes(String, String, Boolean) Methode

Referenz

Definition

Namespace:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.v4.0.Utilities.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 Dokument angeordnet sind.

public Microsoft.Office.Interop.Word.XMLNodes SelectNodes (string xPath, string prefixMapping, bool fastSearchSkippingTextNodes);

member this.SelectNodes : string * string * bool -> Microsoft.Office.Interop.Word.XMLNodes

Public Function SelectNodes (xPath As String, Optional prefixMapping As String, Optional fastSearchSkippingTextNodes As Boolean) As XMLNodes

Parameter

xPath: String

Eine gültige XPath-Zeichenfolge. Weitere Informationen zu XPath finden Sie in der Referenz zu XPath.

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 bezieht Textknoten in die Suche ein. Der Standardwert ist False.

Gibt zurück

XMLNodes

Eine XMLNodes-Auflistung, die alle mit dem XPath-Parameter übereinstimmenden Knoten in der Reihenfolge darstellt, in der sie im Dokument angeordnet sind. null, wenn keine mit dem XPath-Parameter übereinstimmenden Knoten gefunden werden.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die XPath Parameter und PrefixMapping beim Aufrufen der SelectNodes -Methode angegeben werden. Um dieses Beispiel zu verwenden, führen Sie es aus der ThisDocument -Klasse in einem Projekt auf Dokumentebene aus.

private void DocumentSelectNodes()
{
    if (this.XMLSchemaReferences.Count > 0)
    {
        string XPath = "/x:catalog/x:book/x:title";
        object key = 1;
        string PrefixMapping = "xmlns:x=\"" +
            this.XMLSchemaReferences[key].NamespaceURI +
            "\"";
        Word.XMLNodes nodes = this.SelectNodes(XPath, 
            PrefixMapping, true);
    }
    else
    {
        MessageBox.Show("The document does not contain a " +
            "schema reference.");
    }
}

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

Hinweise

Das Festlegen des FastSearchSkippingTextNodes Parameters auf true verringert die Leistung, da Microsoft Office Word alle Knoten in einem Dokument anhand des im Knoten enthaltenen Texts durchsucht.

Optionale Parameter

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

Gilt für:

Freigeben über