DocumentBase.SelectSingleNode, méthode
Retourne un objet Microsoft.Office.Interop.Word.XMLNode représentant le premier nœud dans le document qui correspond au paramètre XPath.
Espace de noms : Microsoft.Office.Tools.Word
Assembly : Microsoft.Office.Tools.Word.v4.0.Utilities (dans Microsoft.Office.Tools.Word.v4.0.Utilities.dll)
Syntaxe
'Déclaration
Public Function SelectSingleNode ( _
xPath As String, _
prefixMapping As String, _
fastSearchSkippingTextNodes As Boolean _
) As XMLNode
public XMLNode SelectSingleNode(
string xPath,
string prefixMapping,
bool fastSearchSkippingTextNodes
)
Paramètres
- xPath
Type : System.String
Chaîne XPath valide.Pour plus d'informations sur XPath, consultez Référence XPath.
- 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 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.
Valeur de retour
Type : Microsoft.Office.Interop.Word.XMLNode
Objet Microsoft.Office.Interop.Word.XMLNode qui représente le premier nœud correspondant au paramètre XPath dans le document ; nullune référence null (Nothing en Visual Basic) si aucun nœud correspondant au paramètre XPath n'est trouvé.
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 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 SelectSingleNode. Pour utiliser cet exemple, exécutez-le à partir de la classe ThisDocument dans un projet au niveau du document.
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
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.");
}
}
Sécurité .NET Framework
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.