DocumentBase.SelectSingleNode-Methode

Artikel
05/07/2013

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

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 SelectSingleNode ( _
    xPath As String, _
    prefixMapping As String, _
    fastSearchSkippingTextNodes As Boolean _
) As XMLNode

public XMLNode SelectSingleNode(
    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.XMLNode
Ein Microsoft.Office.Interop.Word.XMLNode-Objekt, das den ersten Knoten darstellt, der mit dem XPath-Parameter im Dokument übereinstimmt; 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 SelectSingleNode-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 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

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

.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