Partager via


XMLNode.SelectSingleNode, méthode

Obtient un objet Microsoft.Office.Interop.Word.XMLNode représentant le premier nœud enfant qui correspond au paramètre XPath dans le contrôle Microsoft.Office.Tools.Word.XMLNode.

Espace de noms :  Microsoft.Office.Tools.Word
Assembly :  Microsoft.Office.Tools.Word (dans Microsoft.Office.Tools.Word.dll)

Syntaxe

'Déclaration
Function SelectSingleNode ( _
    XPath As String, _
    PrefixMapping As String, _
    FastSearchSkippingTextNodes As Boolean _
) As XMLNode
XMLNode SelectSingleNode(
    string XPath,
    string PrefixMapping,
    bool FastSearchSkippingTextNodes
)

Paramètres

  • PrefixMapping
    Type : System.String
    Fournit le préfixe dans le schéma selon lequel effectuer la recherche.Utilisez le paramètre PrefixMapping si votre paramètre XPath utilise des noms pour rechercher des éléments.
  • FastSearchSkippingTextNodes
    Type : System.Boolean
    true pour ignorer tous les nœuds de texte pendant la recherche du nœud spécifié. false pour inclure les nœuds de texte dans la recherche.La valeur par défaut est true

Valeur de retour

Type : Microsoft.Office.Interop.Word.XMLNode
Premier nœud enfant qui correspond au paramètre XPath dans le contrôle Microsoft.Office.Tools.Word.XMLNode.

Notes

Donner au paramètre FastSearchSkippingTextNodes la valeur false diminue les performances parce que Microsoft Office Word recherche le texte dans tous les nœuds d'un document.

Paramètres optionnels

Pour plus d'informations sur les paramètres optionnels, consultez Paramètres optionnels dans les solutions Office.

Exemples

L'exemple de code suivant utilise la méthode SelectSingleNode pour obtenir un nœud enfant qui correspond au paramètre XPath donné.L'exemple affiche ensuite le nom du nœud qui a été trouvé.Cet exemple suppose que le document actuel contient un XMLNode nommé CustomerNode et que l'élément de schéma correspondant contient un ou plusieurs nœuds enfants nommés LastName.

Private Sub FindLastNameNode()
    Dim element As String = "/x:Customer/x:LastName"
    Dim prefix As String = "xmlns:x='" & _
        Me.CustomerLastNameNode.NamespaceURI & "'"

    Dim node As Word.XMLNode = _
        Me.CustomerNode.SelectSingleNode(element, prefix, True)
    If node IsNot Nothing Then
        MsgBox(node.BaseName & " element was found.")
    Else
        MsgBox("The requested node was not found.")
    End If
End Sub
private void FindLastNameNode()
{
    string element = "/x:Customer/x:LastName";
    string prefix = "xmlns:x='" + 
        this.CustomerLastNameNode.NamespaceURI + "'";

    Word.XMLNode node = this.CustomerNode.SelectSingleNode(element,
        prefix, true);
    if (node != null)
    {
        MessageBox.Show(node.BaseName + " element was found.");
    }
    else
    {
        MessageBox.Show("The requested node was not found.");
    }
}

Sécurité .NET Framework

Voir aussi

Référence

XMLNode Interface

Microsoft.Office.Tools.Word, espace de noms