DocumentBase.SelectSingleNode(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

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.

Retourne un objet XMLNode représentant le premier nœud dans le document qui correspond au paramètre XPath.

public Microsoft.Office.Interop.Word.XMLNode SelectSingleNode (string xPath, string prefixMapping, bool fastSearchSkippingTextNodes);

member this.SelectSingleNode : string * string * bool -> Microsoft.Office.Interop.Word.XMLNode

Public Function SelectSingleNode (xPath As String, Optional prefixMapping As String, Optional fastSearchSkippingTextNodes As Boolean) As XMLNode

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

XMLNode

Objet XMLNode qui représente le premier nœud correspondant au paramètre XPath dans le document ; null si aucun nœud correspondant au paramètre XPath n'est trouvé.

Exemples

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

private void DocumentSelectSingleNode()
{
    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.XMLNode node = this.SelectSingleNode(XPath, 
            PrefixMapping, true);
    }
    else
    {
        MessageBox.Show("The document does not contain a " +
            "schema reference.");
    }
}

Private Sub DocumentSelectSingleNode()
    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.XMLNode = Me.SelectSingleNode(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 à

Partager via