Partager via


XMLNode.SelectNodes, méthode

Obtient une collection Microsoft.Office.Interop.Word.XMLNodes qui représente tous les nœuds correspondant au paramètre XPath dans l'ordre où ils apparaissent 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 SelectNodes ( _
    XPath As String, _
    PrefixMapping As String, _
    FastSearchSkippingTextNodes As Boolean _
) As XMLNodes
XMLNodes SelectNodes(
    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 false

Valeur de retour

Type : Microsoft.Office.Interop.Word.XMLNodes
Nœuds qui correspondent au paramètre XPath dans l'ordre dans lequel ils apparaissent 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 SelectNodes pour obtenir une collection des nœuds enfants qui correspondent au paramètre XPath donné. L'exemple affiche ensuite le nombre de nœuds trouvés. 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 FirstName.

Private Sub DisplayFirstNameNodesCount()
    Dim element As String = "/x:Customer/x:FirstName"
    Dim prefix As String = "xmlns:x='" & _
        Me.CustomerFirstNameNode.NamespaceURI & "'"

    Dim nodes As Word.XMLNodes = _
        Me.CustomerNode.SelectNodes(element, prefix, True)
    MsgBox(nodes.Count & " element(s) were found.")
End Sub
private void DisplayFirstNameNodesCount()
{
    string element = "/x:Customer/x:FirstName";
    string prefix = "xmlns:x='" + 
        this.CustomerFirstNameNode.NamespaceURI + "'";

    Word.XMLNodes nodes = this.CustomerNode.SelectNodes(element, 
        prefix, true);
    MessageBox.Show(nodes.Count + " element(s) were found.");
}

Sécurité .NET Framework

Voir aussi

Référence

XMLNode Interface

Microsoft.Office.Tools.Word, espace de noms