Partager via


XPathNavigator Classe

Définition

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

public ref class XPathNavigator abstract : System::Xml::XPath::XPathItem, ICloneable, System::Xml::IXmlNamespaceResolver, System::Xml::XPath::IXPathNavigable
public ref class XPathNavigator abstract : System::Xml::XPath::XPathItem, System::Xml::IXmlNamespaceResolver, System::Xml::XPath::IXPathNavigable
public ref class XPathNavigator abstract : ICloneable
public abstract class XPathNavigator : System.Xml.XPath.XPathItem, ICloneable, System.Xml.IXmlNamespaceResolver, System.Xml.XPath.IXPathNavigable
public abstract class XPathNavigator : System.Xml.XPath.XPathItem, System.Xml.IXmlNamespaceResolver, System.Xml.XPath.IXPathNavigable
public abstract class XPathNavigator : ICloneable
type XPathNavigator = class
    inherit XPathItem
    interface ICloneable
    interface IXmlNamespaceResolver
    interface IXPathNavigable
type XPathNavigator = class
    inherit XPathItem
    interface IXmlNamespaceResolver
    interface IXPathNavigable
type XPathNavigator = class
    interface ICloneable
type XPathNavigator = class
    inherit XPathItem
    interface ICloneable
    interface IXPathNavigable
    interface IXmlNamespaceResolver
Public MustInherit Class XPathNavigator
Inherits XPathItem
Implements ICloneable, IXmlNamespaceResolver, IXPathNavigable
Public MustInherit Class XPathNavigator
Inherits XPathItem
Implements IXmlNamespaceResolver, IXPathNavigable
Public MustInherit Class XPathNavigator
Implements ICloneable
Héritage
XPathNavigator
Héritage
XPathNavigator
Dérivé
Implémente

Remarques

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

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

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

Important

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

Notes pour les responsables de l’implémentation

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

Constructeurs

XPathNavigator()

Initialise une nouvelle instance de la classe XPathNavigator.

Propriétés

BaseURI

En cas de substitution dans une classe dérivée, obtient l'URI de base du nœud actuel.

CanEdit

Obtient une valeur indiquant si le XPathNavigator peut modifier les données XML sous-jacentes.

HasAttributes

Obtient une valeur indiquant si le nœud actuel a des attributs.

HasChildren

Obtient une valeur indiquant si le nœud actuel a des nœuds enfants.

InnerXml

Obtient ou définit le balisage représentant les nœuds enfants du nœud actuel.

IsEmptyElement

En cas de substitution dans une classe dérivée, obtient une valeur qui indique si le nœud actuel est un élément vide sans étiquette d’élément de fin.

IsNode

Obtient une valeur qui indique si le nœud actuel représente un nœud XPath.

LocalName

En cas de remplacement dans une classe dérivée, obtient le Name du nœud actuel sans aucun préfixe d’espace de noms.

Name

En cas de substitution dans une classe dérivée, obtient le nom qualifié du nœud actuel.

NamespaceURI

En cas de substitution dans une classe dérivée, obtient l'URI de l'espace de noms du nœud actuel.

NameTable

En cas de substitution dans une classe dérivée, obtient XmlNameTable de XPathNavigator.

NavigatorComparer

Obtient un IEqualityComparer utilisé pour la comparaison d’égalité d’objets XPathNavigator.

NodeType

En cas de substitution dans une classe dérivée, obtient le XPathNodeType du nœud actuel.

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.

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.

SchemaInfo

Obtient les informations de schéma qui ont été assignées au nœud actuel à la suite de la validation du schéma.

TypedValue

Récupère le nœud actuel sous forme d’objet boxed du type .NET le plus approprié.

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.

Value

Quand elle est remplacée dans une classe dérivée, obtient la valeur de chaîne de l’élément.

Value

En cas de substitution dans une classe dérivée, obtient la valeur string de l'élément.

(Hérité de XPathItem)
ValueAsBoolean

Obtient la valeur du nœud actuel en tant que Boolean.

ValueAsDateTime

Obtient la valeur du nœud actuel en tant que DateTime.

ValueAsDouble

Obtient la valeur du nœud actuel en tant que Double.

ValueAsInt

Obtient la valeur du nœud actuel en tant que Int32.

ValueAsLong

Obtient la valeur du nœud actuel en tant que Int64.

ValueType

Récupère le Type .NET du nœud actuel.

XmlLang

Obtient l’étendue xml:lang du nœud actuel.

XmlType

Obtient les informations XmlSchemaType pour le nœud actuel.

XmlType

En cas de substitution dans une classe dérivée, obtient le XmlSchemaType de l'élément.

(Hérité de XPathItem)

Méthodes

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.

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.

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

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

AppendChildElement(String, String, String, String)

Crée un nœud d'é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.

CheckValidity(XmlSchemaSet, ValidationEventHandler)

Vérifie que les données XML du XPathNavigator sont conformes au schéma XSD (XML Schema Definition) fourni.

Clone()

En cas de substitution dans une classe dérivée, crée un XPathNavigator positionné au même nœud que ce XPathNavigator.

ComparePosition(XPathNavigator)

Compare la position du XPathNavigator en cours avec la position du XPathNavigator spécifié.

Compile(String)

Compile une chaîne représentant une expression XPath, puis retourne un objet XPathExpression.

CreateAttribute(String, String, String, String)

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.

CreateAttributes()

Retourne un objet XmlWriter permettant de créer des attributs sur l'élément actuel.

CreateNavigator()

Retourne une copie de XPathNavigator.

DeleteRange(XPathNavigator)

Supprime une plage de nœuds frères allant du nœud actuel au nœud spécifié.

DeleteSelf()

Supprime le nœud actuel et ses nœuds enfants.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
Evaluate(String)

Évalue l'expression XPath spécifiée et retourne le résultat typé.

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.

Evaluate(XPathExpression)

Évalue XPathExpression spécifiée et retourne le résultat typé.

Evaluate(XPathExpression, XPathNodeIterator)

Utilise le contexte fourni pour évaluer le XPathExpression et retourne le résultat typé.

GetAttribute(String, String)

Obtient la valeur de l'attribut avec le nom local et l'URI de l'espace de noms spécifiés.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetNamespace(String)

Retourne la valeur du nœud d'espace de noms correspondant au nom local spécifié.

GetNamespacesInScope(XmlNamespaceScope)

Retourne tous les espaces de noms dans la portée du nœud actuel.

GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
InsertAfter()

Retourne un objet XmlWriter permettant de créer un nœud frère après le nœud sélectionné.

InsertAfter(String)

Crée un nœud frère après le nœud actuellement sélectionné à l'aide de la chaîne XML spécifiée.

InsertAfter(XmlReader)

Crée un nœud frère après le nœud actuellement sélectionné en utilisant le contenu XML de l’objet XmlReader spécifié.

InsertAfter(XPathNavigator)

Crée un nœud frère après le nœud actuellement sélectionné à l’aide des nœuds dans l’objet XPathNavigator spécifié.

InsertBefore()

Retourne un objet XmlWriter permettant de créer un nœud frère avant le nœud sélectionné.

InsertBefore(String)

Crée un nœud frère avant le nœud actuellement sélectionné à l'aide de la chaîne XML spécifiée.

InsertBefore(XmlReader)

Crée un nœud frère avant le nœud actuellement sélectionné en utilisant le contenu XML de l’objet XmlReader spécifié.

InsertBefore(XPathNavigator)

Crée un nœud frère avant le nœud actuellement sélectionné à l’aide des nœuds dans l’objet XPathNavigator spécifié.

InsertElementAfter(String, String, String, String)

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.

InsertElementBefore(String, String, String, String)

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.

IsDescendant(XPathNavigator)

Détermine si le XPathNavigator spécifié est un descendant du XPathNavigator en cours.

IsSamePosition(XPathNavigator)

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

LookupNamespace(String)

Obtient l'URI de l'espace de noms du préfixe spécifié.

LookupPrefix(String)

Obtient le préfixe déclaré pour l'URI d'espace de noms spécifié.

Matches(String)

Détermine si le nœud actuel correspond à l'expression XPath spécifiée.

Matches(XPathExpression)

Détermine si le nœud actuel correspond au XPathExpression spécifié.

MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
MoveTo(XPathNavigator)

En cas de substitution dans une classe dérivée, déplace XPathNavigator vers la même position que celle du XPathNavigator spécifié.

MoveToAttribute(String, String)

Déplace le XPathNavigator vers l'attribut avec le nom local et l'URI d'espace de noms spécifiés.

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.

MoveToChild(XPathNodeType)

Déplace le XPathNavigator vers le nœud enfant du XPathNodeType spécifié.

MoveToFirst()

Déplace l'objet XPathNavigator vers le premier nœud frère du nœud actuel.

MoveToFirstAttribute()

En cas de substitution dans une classe dérivée, déplace XPathNavigator vers le premier attribut du nœud actuel.

MoveToFirstChild()

En cas de substitution dans une classe dérivée, déplace XPathNavigator vers le premier attribut enfant du nœud actuel.

MoveToFirstNamespace()

Déplace XPathNavigator vers le premier nœud d'espace du nœud actuel.

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.

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.

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.

MoveToFollowing(XPathNodeType)

Déplace le XPathNavigator vers l'élément suivant du XPathNodeType spécifié dans l'ordre du document.

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.

MoveToId(String)

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 au spécifié String.

MoveToNamespace(String)

Déplace XPathNavigator vers le nœud d'espace de noms correspondant au préfixe d'espace de noms.

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.

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.

MoveToNext(XPathNodeType)

Déplace le XPathNavigator vers le nœud frère suivant du nœud actuel qui correspond au XPathNodeType spécifié.

MoveToNextAttribute()

En cas de substitution dans une classe dérivée, déplace le XPathNavigator vers l'attribut suivant.

MoveToNextNamespace()

Déplace XPathNavigator vers le nœud d'espace de noms suivant.

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.

MoveToParent()

En cas de substitution dans une classe dérivée, déplace XPathNavigator vers le nœud parent du nœud actuel.

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.

MoveToRoot()

Déplace XPathNavigator vers le nœud racine auquel le nœud actuel appartient.

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.

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.

PrependChild(XmlReader)

Crée un nœud enfant au début de la liste des nœuds enfants du nœud actuel en utilisant le contenu XML de l’objet XmlReader spécifié.

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

PrependChildElement(String, String, String, String)

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.

ReadSubtree()

Retourne un objet XmlReader qui contient le nœud actuel et ses nœuds enfants.

ReplaceRange(XPathNavigator)

Remplace une plage de nœuds frères allant du nœud actuel au nœud spécifié.

ReplaceSelf(String)

Remplace le nœud actuel par le contenu de la chaîne spécifiée.

ReplaceSelf(XmlReader)

Remplace le nœud actuel par le contenu de l’objet XmlReader spécifié.

ReplaceSelf(XPathNavigator)

Remplace le nœud actuel par le contenu de l’objet XPathNavigator spécifié.

Select(String)

Sélectionne un ensemble de nœuds à l'aide de l'expression XPath spécifiée.

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.

Select(XPathExpression)

Sélectionne un ensemble de nœuds à l'aide du XPathExpression spécifié.

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.

SelectAncestors(XPathNodeType, Boolean)

Sélectionne tous les nœuds ancêtres du nœud actuel qui possèdent un XPathNodeType correspondant.

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.

SelectChildren(XPathNodeType)

Sélectionne tous les nœuds enfants du nœud actuel dotés du XPathNodeType correspondant.

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.

SelectDescendants(XPathNodeType, Boolean)

Sélectionne tous les nœuds descendants du nœud actuel qui possèdent un XPathNodeType correspondant.

SelectSingleNode(String)

Sélectionne un nœud dans XPathNavigator à l'aide de la requête XPath spécifiée.

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.

SelectSingleNode(XPathExpression)

Sélectionne un nœud dans XPathNavigator à l'aide de l'objet XPathExpression spécifiée.

SetTypedValue(Object)

Définit la valeur typée du nœud actuel.

SetValue(String)

Définit la valeur du nœud actuel.

ToString()

Obtient le texte du nœud actuel.

ValueAs(Type)

Retourne la valeur de l'élément comme type spécifié.

(Hérité de XPathItem)
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.

WriteSubtree(XmlWriter)

Transmet en continu le nœud actuel et ses nœuds enfants à l’objet XmlWriter spécifié.

Implémentations d’interfaces explicites

ICloneable.Clone()

Crée une copie de l'objet XPathNavigator.

S’applique à

Voir aussi