Document.SelectNodes, méthode (System 2007)

Mise à jour : novembre 2007

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

Espace de noms :  Microsoft.Office.Tools.Word
Assembly :  Microsoft.Office.Tools.Word.v9.0 (dans Microsoft.Office.Tools.Word.v9.0.dll)

Syntaxe

Public Function SelectNodes ( _
    XPath As String, _
    PrefixMapping As String, _
    FastSearchSkippingTextNodes As Boolean _
) As XMLNodes

Dim instance As Document
Dim XPath As String
Dim PrefixMapping As String
Dim FastSearchSkippingTextNodes As Boolean
Dim returnValue As XMLNodes

returnValue = instance.SelectNodes(XPath, _
    PrefixMapping, FastSearchSkippingTextNodes)
public XMLNodes SelectNodes(
    string XPath,
    string PrefixMapping,
    bool FastSearchSkippingTextNodes
)

Paramètres

  • XPath
    Type : System.String

    Chaîne XPath valide. Pour plus d'informations sur XPath, consultez la documentation de référence de XPath sur le site Web de Microsoft Developer Network (MSDN).

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

Valeur de retour

Type : Microsoft.Office.Interop.Word.XMLNodes

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

Notes

Affecter la valeur true au paramètre FastSearchSkippingTextNodes diminue les performances, car 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 Fonctionnement des paramètres optionnels dans les solutions Office.

Exemples

L'exemple de code suivant montre comment spécifier les paramètres XPath et PrefixMapping lors de l'appel de la méthode SelectNodes.

Cet exemple illustre une personnalisation au niveau du document.

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
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.get_Item(ref key).NamespaceURI +
            "\"";

        Word.XMLNodes nodes = this.SelectNodes(XPath, 
            PrefixMapping, true);
    }
    else
    {
        MessageBox.Show("The document does not contain a " +
            "schema reference.");
    }
}

Autorisations

Voir aussi

Référence

Document, classe

Membres Document

Microsoft.Office.Tools.Word, espace de noms