DocumentBase.SelectNodes(String, String, Boolean) Méthode
Définition
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 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
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.