XMLNode.SelectSingleNode, méthode

Article
01/06/2014

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

XPath
Type : System.String
Chaîne XPath valide.

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

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

XMLNode Interface

Microsoft.Office.Tools.Word, espace de noms

Partager via