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

  • Référence

Définition

Espace de noms:
Microsoft.Office.Tools.Word
Assembly:
Microsoft.Office.Tools.Word.v4.0.Utilities.dll

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

public Microsoft.Office.Interop.Word.XMLNodes SelectNodes (string xPath, string prefixMapping, bool fastSearchSkippingTextNodes);
member this.SelectNodes : string * string * bool -> Microsoft.Office.Interop.Word.XMLNodes
Public Function SelectNodes (xPath As String, Optional prefixMapping As String, Optional fastSearchSkippingTextNodes As Boolean) As XMLNodes

Paramètres

xPath
String

Chaîne XPath valide. Pour plus d'informations sur XPath, consultez Référence XPath.

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 ignore tous les nœuds de texte pendant la recherche du nœud spécifié. false inclut des nœuds de texte dans la recherche. La valeur par défaut est False.

Retours

XMLNodes

Collection XMLNodes qui représente tous les nœuds correspondant au paramètre XPath dans l'ordre dans lequel ils apparaissent dans le document ; null si les nœuds correspondant au paramètre XPath sont introuvables.

Exemples

L’exemple de code suivant montre comment spécifier les paramètres et PrefixMapping lors de l’appel XPath de la SelectNodes méthode. Pour utiliser cet exemple, exécutez-le à partir de la ThisDocument classe dans un projet au niveau du document.

private void DocumentSelectNodes()
{
    if (this.XMLSchemaReferences.Count > 0)
    {
        string XPath = "/x:catalog/x:book/x:title";
        object key = 1;
        string PrefixMapping = "xmlns:x=\"" +
            this.XMLSchemaReferences[key].NamespaceURI +
            "\"";
        Word.XMLNodes nodes = this.SelectNodes(XPath, 
            PrefixMapping, true);
    }
    else
    {
        MessageBox.Show("The document does not contain a " +
            "schema reference.");
    }
}

Private Sub DocumentSelectNodes()
    If Me.XMLSchemaReferences.Count > 0 Then
        Dim XPath As String = "/x:catalog/x:book/x:title"
        Dim PrefixMapping As String = "xmlns:x=""" + _
            Me.XMLSchemaReferences(1).NamespaceURI + """"
        Dim node As Word.XMLNodes = Me.SelectNodes(XPath, _
            PrefixMapping, True)
    Else
        MessageBox.Show("The document does not contain a " + _
            "schema reference.")
    End If
End Sub

Remarques

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

Paramètres facultatifs

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

S’applique à