DocumentBase.SelectSingleNode(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.

Gibt ein XMLNode-Objekt zurück, das den ersten Knoten im Dokument darstellt, der mit dem XPath-Parameter übereinstimmt.

public Microsoft.Office.Interop.Word.XMLNode SelectSingleNode (string xPath, string prefixMapping, bool fastSearchSkippingTextNodes);

member this.SelectSingleNode : string * string * bool -> Microsoft.Office.Interop.Word.XMLNode

Public Function SelectSingleNode (xPath As String, Optional prefixMapping As String, Optional fastSearchSkippingTextNodes As Boolean) As XMLNode

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

XMLNode

Ein XMLNode-Objekt, das den ersten Knoten darstellt, der mit dem XPath-Parameter im Dokument übereinstimmt; 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 SelectSingleNode -Methode angegeben werden. Um dieses Beispiel zu verwenden, führen Sie es in der ThisDocument -Klasse in einem Projekt auf Dokumentebene aus.

private void DocumentSelectSingleNode()
{
    if (this.XMLSchemaReferences.Count > 0)
    {
        string XPath = "/x:catalog/x:book/x:title";
        object key = 1;

        string PrefixMapping = "xmlns:x=\"" +
            this.XMLSchemaReferences.get_Item(ref key).NamespaceURI +
            "\"";

        Word.XMLNode node = this.SelectSingleNode(XPath, 
            PrefixMapping, true);
    }
    else
    {
        MessageBox.Show("The document does not contain a " +
            "schema reference.");
    }
}

Private Sub DocumentSelectSingleNode()
    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.XMLNode = Me.SelectSingleNode(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 verringert true 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