DocumentBase.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 Dokument angeordnet sind.

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

Syntax

'Declaration
Public Function SelectNodes ( _
    xPath As String, _
    prefixMapping As String, _
    fastSearchSkippingTextNodes As Boolean _
) As XMLNodes

public XMLNodes SelectNodes(
    string xPath,
    string prefixMapping,
    bool fastSearchSkippingTextNodes
)

Parameter

xPath
Typ: System.String
Eine gültige XPath-Zeichenfolge.Weitere Informationen zu XPath finden Sie in der Referenz zu XPath.

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

Rückgabewert

Typ: Microsoft.Office.Interop.Word.XMLNodes
Eine Microsoft.Office.Interop.Word.XMLNodes-Auflistung, die alle mit dem XPath-Parameter übereinstimmenden Knoten in der Reihenfolge darstellt, in der sie im Dokument angeordnet sind. nullein Nullverweis (Nothing in Visual Basic), wenn keine mit dem XPath-Parameter übereinstimmenden Knoten gefunden werden.

Hinweise

Wenn der FastSearchSkippingTextNodes-Parameter auf true 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 veranschaulicht, wie der XPath-Parameter und der PrefixMapping-Parameter angegeben werden, wenn die SelectNodes-Methode aufgerufen wird. Wenn Sie dieses Beispiel verwenden möchten, führen Sie es von der ThisDocument-Klasse in einem Projekt auf Dokumentebene aus.

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

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

.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

DocumentBase Klasse

Microsoft.Office.Tools.Word-Namespace

Freigeben über