XPathNavigator, classe (System.Xml.XPath)

Changer de vue:
Classique
Lightweight
ScriptFree
Bibliothèque de classes .NET Framework
XPathNavigator, classe
Cet article a fait l'objet d'une traduction manuelle. Pour afficher simultanément cette page et le contenu source en anglais, choisissez le paramètre d'affichage Basse densité.

Fournit un modèle de curseur pour la navigation dans les données XML et leur modification.

Hiérarchie d'héritage
System.Object
  System.Xml.XPath.XPathItem
    System.Xml.XPath.XPathNavigator
      System.ServiceModel.Dispatcher.SeekableXPathNavigator

Espace de noms :  System.Xml.XPath
Assembly :  System.Xml (dans System.Xml.dll)
Syntaxe
Visual Basic
Public MustInherit Class XPathNavigator _
	Inherits XPathItem _
	Implements ICloneable, IXPathNavigable, IXmlNamespaceResolver
C#
public abstract class XPathNavigator : XPathItem, 
	ICloneable, IXPathNavigable, IXmlNamespaceResolver
VisualC++
public ref class XPathNavigator abstract : public XPathItem, 
	ICloneable, IXPathNavigable, IXmlNamespaceResolver
F#
[<AbstractClass>]
type XPathNavigator =  
    class
        inherit XPathItem
        interface ICloneable
        interface IXPathNavigable
        interface IXmlNamespaceResolver
    end

Le type XPathNavigator expose les membres suivants.

Constructeurs
  Nom Description
Méthode protégée XPathNavigator Initialise une nouvelle instance de la classe XPathNavigator.
Début
Propriétés
  Nom Description
Propriété publique BaseURI En cas de substitution dans une classe dérivée, obtient l'URI de base du nœud actuel.
Propriété publique CanEdit Obtient une valeur indiquant si XPathNavigator peut modifier les données XML sous-jacentes.
Propriété publique HasAttributes Obtient une valeur indiquant si le nœud actuel possède des attributs.
Propriété publique HasChildren Obtient une valeur indiquant si le nœud actuel possède des nœuds enfants.
Propriété publique InnerXml Obtient ou définit le balisage représentant les nœuds enfants du nœud actuel.
Propriété publique IsEmptyElement En cas de substitution dans une classe dérivée, obtient une valeur indiquant si le nœud actuel est un élément vide sans balise d'élément de fin.
Propriété publique IsNode Obtient une valeur indiquant si le nœud actuel représente un nœud XPath. (Substitue XPathItem.IsNode.)
Propriété publique LocalName En cas de substitution dans une classe dérivée, obtient le Name du nœud actuel sans préfixe d'espace de noms.
Propriété publique Name En cas de substitution dans une classe dérivée, obtient le nom qualifié du nœud actuel.
Propriété publique NamespaceURI En cas de substitution dans une classe dérivée, obtient l'URI de l'espace de noms du nœud actuel.
Propriété publique NameTable En cas de substitution dans une classe dérivée, obtient XmlNameTable de XPathNavigator.
Propriété publique Membre statique NavigatorComparer Obtient un IEqualityComparer utilisé pour la comparaison d'égalité d'objets XPathNavigator.
Propriété publique NodeType En cas de substitution dans une classe dérivée, obtient le XPathNodeType du nœud actuel.
Propriété publique OuterXml Obtient ou définit le balisage représentant les balises d'ouverture et de fermeture du nœud actuel et de ses nœuds enfants.
Propriété publique Prefix En cas de substitution dans une classe dérivée, obtient le préfixe de l'espace de noms associé au nœud actuel.
Propriété publique SchemaInfo Obtient les informations de schéma qui ont été assignées au nœud actuel à la suite de la validation du schéma.
Propriété publique TypedValue Obtient le nœud actuel en tant qu'objet boxed du type .NET Framework le plus approprié. (Substitue XPathItem.TypedValue.)
Propriété publique UnderlyingObject Utilisé par les implémentations de XPathNavigator qui fournissent un affichage XML « virtualisé » d'un magasin, en vue de proposer un accès aux objets sous-jacents.
Propriété publique Value En cas de substitution dans une classe dérivée, obtient la valeur string de l'élément. (Hérité de XPathItem.)
Propriété publique ValueAsBoolean Obtient la valeur du nœud actuel en tant que Boolean. (Substitue XPathItem.ValueAsBoolean.)
Propriété publique ValueAsDateTime Obtient la valeur du nœud actuel en tant que DateTime. (Substitue XPathItem.ValueAsDateTime.)
Propriété publique ValueAsDouble Obtient la valeur du nœud actuel en tant que Double. (Substitue XPathItem.ValueAsDouble.)
Propriété publique ValueAsInt Obtient la valeur du nœud actuel en tant que Int32. (Substitue XPathItem.ValueAsInt.)
Propriété publique ValueAsLong Obtient la valeur du nœud actuel en tant que Int64. (Substitue XPathItem.ValueAsLong.)
Propriété publique ValueType Obtient le nœud actuel Type du .NET Framework. (Substitue XPathItem.ValueType.)
Propriété publique XmlLang Obtient la portée xml:lang pour le nœud actuel.
Propriété publique XmlType Obtient les informations XmlSchemaType pour le nœud actuel. (Substitue XPathItem.XmlType.)
Début
Méthodes
  Nom Description
Méthode publique AppendChild() Retourne un objet XmlWriter permettant de créer un ou plusieurs nœuds enfants à la fin de la liste de nœuds enfants du nœud actuel.
Méthode publique AppendChild(String) Crée un nœud enfant à la fin de la liste de nœuds enfants du nœud actuel à l'aide de la chaîne de données XML spécifiée.
Méthode publique AppendChild(XmlReader) Crée un nœud enfant à la fin de la liste de nœuds enfants du nœud actuel à l'aide du contenu XML de l'objet XmlReader spécifié.
Méthode publique AppendChild(XPathNavigator) Crée un nœud enfant à la fin de la liste de nœuds enfants du nœud actuel à l'aide des nœuds du XPathNavigator spécifié.
Méthode publique AppendChildElement Crée un élément enfant à la fin de la liste de nœuds enfants du nœud actuel à l'aide du préfixe d'espace de noms, du nom local et de l'URI d'espace de noms spécifiés avec la valeur spécifiée.
Méthode publique CheckValidity Vérifie que les données XML du XPathNavigator sont conformes au schéma XSD (XML Schema Definition) fourni.
Méthode publique Clone En cas de substitution dans une classe dérivée, crée un XPathNavigator positionné au même nœud que ce XPathNavigator.
Méthode publique ComparePosition Compare la position du XPathNavigator en cours avec la position du XPathNavigator spécifié.
Méthode publique Compile Compile une chaîne représentant une expression XPath, puis retourne un objet XPathExpression.
Méthode publique CreateAttribute Crée un nœud d'attribut sur le nœud d'élément actuel à l'aide du préfixe d'espace de noms, du nom local et de l'URI d'espace de noms spécifiés avec la valeur spécifiée.
Méthode publique CreateAttributes Retourne un objet XmlWriter permettant de créer des attributs sur l'élément actuel.
Méthode publique CreateNavigator Retourne une copie de XPathNavigator.
Méthode publique DeleteRange Supprime une plage de nœuds frères allant du nœud actuel au nœud spécifié.
Méthode publique DeleteSelf Supprime le nœud actuel et ses nœuds enfants.
Méthode publique Equals(Object) Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode publique Evaluate(String) Évalue l'expression XPath spécifiée et retourne le résultat typé.
Méthode publique Evaluate(XPathExpression) Évalue XPathExpression spécifiée et retourne le résultat typé.
Méthode publique Evaluate(String, IXmlNamespaceResolver) Évalue l'expression XPath spécifiée et retourne le résultat typé, à l'aide de l'objet IXmlNamespaceResolver spécifié pour trouver les préfixes d'espace de noms dans l'expression XPath.
Méthode publique Evaluate(XPathExpression, XPathNodeIterator) Utilise le contexte fourni pour évaluer le XPathExpression et retourne le résultat typé.
Méthode protégée Finalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publique GetAttribute Obtient la valeur de l'attribut avec le nom local et l'URI d'espace de noms spécifiés.
Méthode publique GetHashCode Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publique GetNamespace Retourne la valeur du nœud d'espace de noms correspondant au nom local spécifié.
Méthode publique GetNamespacesInScope Retourne tous les espaces de noms dans la portée du nœud actuel.
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publique InsertAfter() Retourne un objet XmlWriter permettant de créer un nœud frère après le nœud sélectionné.
Méthode publique InsertAfter(String) Crée un nouveau nœud frère après le nœud sélectionné actuellement à l'aide de la chaîne XML spécifiée.
Méthode publique InsertAfter(XmlReader) Crée un nœud frère après le nœud sélectionné à l'aide du contenu XML de l'objet XmlReader spécifié.
Méthode publique InsertAfter(XPathNavigator) Crée un nœud frère après le nœud sélectionné à l'aide des nœuds dans l'objet XPathNavigator spécifié.
Méthode publique InsertBefore() Retourne un objet XmlWriter permettant de créer un nœud frère avant le nœud sélectionné.
Méthode publique InsertBefore(String) Crée un nœud frère avant le nœud sélectionné à l'aide de la chaîne XML spécifiée.
Méthode publique InsertBefore(XmlReader) Crée un nœud frère avant le nœud sélectionné à l'aide du contenu XML de l'objet XmlReader spécifié.
Méthode publique InsertBefore(XPathNavigator) Crée un nœud frère avant le nœud sélectionné à l'aide des nœuds dans XPathNavigator spécifié.
Méthode publique InsertElementAfter Crée un élément frère après le nœud actuel à l'aide du préfixe d'espace de noms, du nom local et de l'URI d'espace de noms spécifiés, avec la valeur spécifiée.
Méthode publique InsertElementBefore Crée un élément frère avant le nœud actuel à l'aide du préfixe d'espace de noms, du nom local et de l'URI d'espace de noms spécifiés, avec la valeur spécifiée.
Méthode publique IsDescendant Détermine si le XPathNavigator spécifié est un descendant du XPathNavigator en cours.
Méthode publique IsSamePosition En cas de substitution dans une classe dérivée, détermine si le XPathNavigator actuel est à la même position que le XPathNavigator spécifié.
Méthode publique LookupNamespace Obtient l'URI de l'espace de noms du préfixe spécifié.
Méthode publique LookupPrefix Obtient le préfixe déclaré pour l'URI d'espace de noms spécifié.
Méthode publique Matches(String) Détermine si le nœud actuel correspond à l'expression XPath spécifiée.
Méthode publique Matches(XPathExpression) Détermine si le nœud actuel correspond au XPathExpression spécifié.
Méthode protégée MemberwiseClone Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode publique MoveTo En cas de substitution dans une classe dérivée, déplace XPathNavigator vers la même position que celle du XPathNavigator spécifié.
Méthode publique MoveToAttribute Déplace le XPathNavigator vers l'attribut avec le nom local et l'URI d'espace de noms spécifiés.
Méthode publique MoveToChild(XPathNodeType) Déplace le XPathNavigator vers le nœud enfant du XPathNodeType spécifié.
Méthode publique MoveToChild(String, String) Déplace XPathNavigator vers le nœud enfant doté du nom local et de l'URI d'espace de noms spécifiés.
Méthode publique MoveToFirst Déplace XPathNavigator vers le premier nœud frère du nœud actuel.
Méthode publique MoveToFirstAttribute En cas de substitution dans une classe dérivée, déplace XPathNavigator vers le premier attribut du nœud actuel.
Méthode publique MoveToFirstChild En cas de substitution dans une classe dérivée, déplace XPathNavigator vers le premier attribut enfant du nœud actuel.
Méthode publique MoveToFirstNamespace() Déplace XPathNavigator vers le premier nœud d'espace du nœud actuel.
Méthode publique MoveToFirstNamespace(XPathNamespaceScope) En cas de substitution dans une classe dérivée, déplace XPathNavigator vers le premier nœud d'espace de noms qui correspond à la XPathNamespaceScope spécifiée.
Méthode publique MoveToFollowing(XPathNodeType) Déplace le XPathNavigator vers l'élément suivant du XPathNodeType spécifié dans l'ordre du document.
Méthode publique MoveToFollowing(String, String) Déplace le XPathNavigator vers l'élément dont le nom local et l'URI d'espace de noms sont spécifiés dans l'ordre du document.
Méthode publique MoveToFollowing(XPathNodeType, XPathNavigator) Déplace le XPathNavigator vers l'élément suivant du XPathNodeType spécifié, à la limite spécifiée, dans l'ordre du document.
Méthode publique MoveToFollowing(String, String, XPathNavigator) Déplace le XPathNavigator vers l'élément avec le nom local et l'URI d'espace de noms spécifiés, à la limite spécifiée, dans l'ordre du document.
Méthode publique MoveToId En cas de substitution dans une classe dérivée, se déplace vers le nœud qui a un attribut de type ID dont la valeur correspond à la String spécifiée.
Méthode publique MoveToNamespace Déplace XPathNavigator vers le nœud d'espace de noms correspondant au préfixe d'espace de noms.
Méthode publique MoveToNext() En cas de substitution dans une classe dérivée, déplace XPathNavigator vers le nœud frère suivant du nœud actuel.
Méthode publique MoveToNext(XPathNodeType) Déplace le XPathNavigator vers le nœud frère suivant du nœud actuel qui correspond au XPathNodeType spécifié.
Méthode publique MoveToNext(String, String) Déplace XPathNavigator vers le nœud frère suivant doté du nom local et de l'URI d'espace de noms spécifiés.
Méthode publique MoveToNextAttribute En cas de substitution dans une classe dérivée, déplace le XPathNavigator vers l'attribut suivant.
Méthode publique MoveToNextNamespace() Déplace XPathNavigator vers le nœud d'espace de noms suivant.
Méthode publique MoveToNextNamespace(XPathNamespaceScope) En cas de substitution dans une classe dérivée, déplace XPathNavigator vers le nœud d'espace de noms suivant qui correspond à la XPathNamespaceScope spécifiée.
Méthode publique MoveToParent En cas de substitution dans une classe dérivée, déplace XPathNavigator vers le nœud parent du nœud actuel.
Méthode publique MoveToPrevious En cas de substitution dans une classe dérivée, déplace XPathNavigator vers le nœud frère précédent du nœud actuel.
Méthode publique MoveToRoot Déplace XPathNavigator vers le nœud racine auquel le nœud actuel appartient.
Méthode publique PrependChild() Retourne un objet XmlWriter permettant de créer un nœud enfant au début de la liste de nœuds enfants du nœud actuel.
Méthode publique PrependChild(String) Crée un nœud enfant au début de la liste de nœuds enfants du nœud actuel à l'aide de la chaîne XML spécifiée.
Méthode publique PrependChild(XmlReader) Crée un nœud enfant au début de la liste de nœuds enfants du nœud actuel à l'aide du contenu XML de l'objet XmlReader spécifié.
Méthode publique PrependChild(XPathNavigator) Crée un nœud enfant au début de la liste de nœuds enfants du nœud actuel à l'aide des nœuds de l'objet XPathNavigator spécifié.
Méthode publique PrependChildElement Crée un élément enfant au début de la liste de nœuds enfants du nœud actuel à l'aide du préfixe d'espace de noms, du nom local et de l'URI d'espace de noms spécifiés avec la valeur spécifiée.
Méthode publique ReadSubtree Retourne un objet XmlReader qui contient le nœud actuel et ses nœuds enfants.
Méthode publique ReplaceRange Remplace une plage de nœuds frères allant du nœud actuel au nœud spécifié.
Méthode publique ReplaceSelf(String) Remplace le nœud actuel par le contenu de la chaîne spécifiée.
Méthode publique ReplaceSelf(XmlReader) Remplace le nœud actuel par le contenu de l'objet XmlReader spécifié.
Méthode publique ReplaceSelf(XPathNavigator) Remplace le nœud actuel par le contenu de l'objet XPathNavigator spécifié.
Méthode publique Select(String) Sélectionne un ensemble de nœuds à l'aide de l'expression XPath spécifiée.
Méthode publique Select(XPathExpression) Sélectionne un ensemble de nœuds à l'aide du XPathExpression spécifié.
Méthode publique Select(String, IXmlNamespaceResolver) Sélectionne un ensemble de nœuds à l'aide de l'expression XPath spécifiée avec l'objet IXmlNamespaceResolver spécifié pour trouver les préfixes d'espace de noms.
Méthode publique SelectAncestors(XPathNodeType, Boolean) Sélectionne tous les nœuds ancêtres du nœud actuel qui possèdent un XPathNodeType correspondant.
Méthode publique SelectAncestors(String, String, Boolean) Sélectionne tous les nœuds ancêtres du nœud actuel dotés du nom local et de l'URI d'espace de noms spécifiés.
Méthode publique SelectChildren(XPathNodeType) Sélectionne tous les nœuds enfants du nœud actuel dotés du XPathNodeType correspondant.
Méthode publique SelectChildren(String, String) Sélectionne tous les nœuds enfants du nœud actuel dotés du nom local et de l'URI d'espace de noms spécifiés.
Méthode publique SelectDescendants(XPathNodeType, Boolean) Sélectionne tous les nœuds descendants du nœud actuel qui possèdent un XPathNodeType correspondant.
Méthode publique SelectDescendants(String, String, Boolean) Sélectionne tous les nœuds descendants du nœud actuel dotés du nom local et de l'URI d'espace de noms spécifiés.
Méthode publique SelectSingleNode(String) Sélectionne un nœud dans XPathNavigator à l'aide de la requête XPath spécifiée.
Méthode publique SelectSingleNode(XPathExpression) Sélectionne un nœud dans XPathNavigator à l'aide de l'objet XPathExpression spécifiée.
Méthode publique SelectSingleNode(String, IXmlNamespaceResolver) Sélectionne un nœud dans l'objet XPathNavigator à l'aide de la requête XPath spécifiée avec l'objet IXmlNamespaceResolver spécifié pour trouver les préfixes d'espace de noms.
Méthode publique SetTypedValue Définit la valeur typée du nœud actuel.
Méthode publique SetValue Définit la valeur du nœud actuel.
Méthode publique ToString Obtient le texte du nœud actuel. (Substitue Object.ToString().)
Méthode publique ValueAs(Type) Retourne la valeur de l'élément comme type spécifié. (Hérité de XPathItem.)
Méthode publique ValueAs(Type, IXmlNamespaceResolver) Obtient la valeur du nœud actuel en tant que Type spécifié, à l'aide de l'objet IXmlNamespaceResolver spécifié pour trouver les préfixes d'espace de noms. (Substitue XPathItem.ValueAs(Type, IXmlNamespaceResolver).)
Méthode publique WriteSubtree Transmet en continu le nœud actuel et ses nœuds enfants à l'objet XmlWriter spécifié.
Début
Implémentations d'interface explicite
  Nom Description
Implémentation d'interface explicite Méthode privée ICloneable.Clone Pour obtenir une description de ce membre, consultez XPathNavigator.Clone.
Début
Notes

La classe XPathNavigator dans l'espace de noms System.Xml.XPath est une classe abstraite qui définit un modèle de curseur pour la navigation dans les éléments d'informations XML et leur modification en tant qu'instances du modèle de données XQuery 1.0 et XPath 2.0.

Un objet XPathNavigator est créé à partir d'une classe qui implémente l'interface IXPathNavigable telle que les classes XmlDocument et XPathDocument. Les objets XPathNavigator créés par les objets XPathDocument sont en lecture seule tandis que les objets XPathNavigator créés par les objets XmlDocument peuvent être modifiés. Le statut de lecture seule ou modifiable d'un objet XPathNavigator est déterminé à l'aide de la propriété CanEdit de la classe XPathNavigator.

Pour plus d'informations sur le traitement des données XML à l'aide du modèle de données XPath, consultez la rubrique Traitement des données XML à l'aide du modèle de données XPath.

Note de sécurité Note de sécurité

Les exceptions levées à la suite de l'utilisation de la classe XPathNavigator, par exemple la classe XPathException, peuvent contenir des informations sensibles qui ne doivent pas être exposées dans des scénarios non fiables. Les exceptions doivent être correctement gérées afin que ces informations sensibles ne soient pas exposées dans des scénarios non fiables.

Remarques à l'attention des héritiers

Lorsque vous héritez de la classe XPathNavigator, vous devez substituer les membres suivants :

Informations de version

.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1
Plateformes

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Sécurité des threads
Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Voir aussi

Référence

System.Xml.XPath, espace de noms
IXPathNavigable
XPathDocument
XmlDocument
XmlNode

Autres ressources

Traitement des données XML à l'aide du modèle de données XPath