XMLNode.SelectNodes(String, String, Boolean) Méthode

Référence

Définition

Espace de noms:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient une collection XMLNodes qui représente tous les nœuds correspondant au paramètre XPath dans l'ordre où ils apparaissent dans le contrôle XMLNode.

public Microsoft.Office.Interop.Word.XMLNodes SelectNodes (string XPath, string PrefixMapping = "", bool FastSearchSkippingTextNodes = true);

abstract member SelectNodes : string * string * bool -> Microsoft.Office.Interop.Word.XMLNodes

Public Function SelectNodes (XPath As String, Optional PrefixMapping As String = "", Optional FastSearchSkippingTextNodes As Boolean = true) As XMLNodes

Paramètres

XPath: String

Chaîne XPath valide.

PrefixMapping: String

Fournit le préfixe dans le schéma selon lequel effectuer la recherche. Utilisez le PrefixMapping paramètre si votre XPath paramètre utilise des noms pour rechercher des éléments.

FastSearchSkippingTextNodes: 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.

Retours

XMLNodes

Nœuds qui correspondent au paramètre XPath dans l'ordre dans lequel ils apparaissent dans le contrôle XMLNode.

Exemples

L’exemple de code suivant utilise la SelectNodes méthode pour obtenir une collection des nœuds enfants qui correspondent au paramètre donné XPath . L’exemple affiche ensuite le nombre de nœuds trouvés. Cet exemple suppose que le document actif contient un XMLNode nommé CustomerNode avec un élément de schéma correspondant qui contient un ou plusieurs nœuds enfants nommés FirstName.

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

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

Remarques

La définition du FastSearchSkippingTextNodes paramètre sur false diminue les performances, car Microsoft Office Word recherche le texte contenu dans le nœud dans tous les nœuds d’un document.

Paramètres facultatifs

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

S’applique à

Partager via