XMLNode.SelectNodes, méthode

Article
08/10/2011

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

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 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

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