XMLNode.SelectSingleNode(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 un objet XMLNode représentant le premier nœud enfant qui correspond au paramètre XPath dans le contrôle XMLNode.

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

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

Public Function SelectSingleNode (XPath As String, Optional PrefixMapping As String = "", Optional FastSearchSkippingTextNodes As Boolean = true) As XMLNode

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

Retours

XMLNode

Premier nœud enfant qui correspond au paramètre XPath dans le contrôle XMLNode.

Exemples

L’exemple de code suivant utilise la SelectSingleNode méthode pour obtenir un nœud enfant qui correspond au paramètre donné XPath . L’exemple affiche ensuite le nom du nœud trouvé. 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 LastName.

private void FindLastNameNode()
{
    string element = "/x:Customer/x:LastName";
    string prefix = "xmlns:x='" + 
        this.CustomerLastNameNode.NamespaceURI + "'";

    Word.XMLNode node = this.CustomerNode.SelectSingleNode(element,
        prefix, true);
    if (node != null)
    {
        MessageBox.Show(node.BaseName + " element was found.");
    }
    else
    {
        MessageBox.Show("The requested node was not found.");
    }
}

Private Sub FindLastNameNode()
    Dim element As String = "/x:Customer/x:LastName"
    Dim prefix As String = "xmlns:x='" & _
        Me.CustomerLastNameNode.NamespaceURI & "'"

    Dim node As Word.XMLNode = _
        Me.CustomerNode.SelectSingleNode(element, prefix, True)
    If node IsNot Nothing Then
        MsgBox(node.BaseName & " element was found.")
    Else
        MsgBox("The requested node was not found.")
    End If
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