XPathNavigator Classe

Définition

Espace de noms:

System.Xml.XPath

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Source:

XPathNavigator.cs

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

public ref class XPathNavigator abstract : System::Xml::XPath::XPathItem, ICloneable, System::Xml::IXmlNamespaceResolver, System::Xml::XPath::IXPathNavigable

public abstract class XPathNavigator : System.Xml.XPath.XPathItem, ICloneable, System.Xml.IXmlNamespaceResolver, System.Xml.XPath.IXPathNavigable

type XPathNavigator = class
    inherit XPathItem
    interface ICloneable
    interface IXmlNamespaceResolver
    interface IXPathNavigable

Public MustInherit Class XPathNavigator
Inherits XPathItem
Implements ICloneable, IXmlNamespaceResolver, IXPathNavigable

Héritage

Object

XPathItem

XPathNavigator

Dérivé

System.ServiceModel.Dispatcher.SeekableXPathNavigator

Implémente

ICloneable IXmlNamespaceResolver IXPathNavigable

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 classes et XmlDocument les XPathDocument classes. 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 de la rubrique XPath Data Model .

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 gérées correctement 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 :

• NameTable

• Clone()

• NodeType

• LocalName

• Name

• NamespaceURI

• Prefix

• BaseURI

• IsEmptyElement

• MoveToFirstAttribute()

• MoveToNextAttribute()

• MoveToFirstNamespace(XPathNamespaceScope)

• MoveToNextNamespace(XPathNamespaceScope)

• MoveToNext()

• MoveToPrevious()

• MoveToFirstChild()

• MoveToParent()

• MoveTo(XPathNavigator)

• MoveToId(String)

• IsSamePosition(XPathNavigator)

• Value

Constructeurs

Nom	Description
XPathNavigator()	Initialise une nouvelle instance de la classe XPathNavigator.

Propriétés

Nom	Description
BaseURI	En cas de substitution dans une classe dérivée, obtient l’URI de base du nœud actuel.
CanEdit	Obtient une valeur qui indique si le XPathNavigator fichier peut modifier les données XML sous-jacentes.
HasAttributes	Obtient une valeur qui indique si le nœud actuel a des attributs.
HasChildren	Obtient une valeur qui indique 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 balise d’élément final.
IsNode	Obtient une valeur qui indique si le nœud actuel représente un nœud XPath.
LocalName	En cas de substitution dans une classe dérivée, obtient le Name nœud actuel sans 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 d’espace de noms du nœud actuel.
NameTable	En cas de substitution dans une classe dérivée, obtient le XmlNameTableXPathNavigator.
NavigatorComparer	Obtient une IEqualityComparer valeur utilisée pour la comparaison d’égalité des XPathNavigator objets.
NodeType	En cas de substitution dans une classe dérivée, obtient le XPathNodeType 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 d’espace de noms associé au nœud actuel.
SchemaInfo	Obtient les informations de schéma qui ont été affectées au nœud actuel à la suite de la validation du schéma.
TypedValue	Obtient le nœud actuel en tant qu’objet boxed du type .NET le plus approprié.
UnderlyingObject	Utilisé par XPathNavigator les implémentations qui fournissent une vue XML « virtualisée » sur un magasin, pour fournir l’accès aux objets sous-jacents.
Value	En cas de substitution dans une classe dérivée, obtient la string valeur 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	Obtient le .NET Type du nœud actuel.
XmlLang	Obtient l’étendue xml:lang du nœud actuel.
XmlType	Obtient les XmlSchemaType informations du nœud actuel.

Méthodes

Nom	Description
AppendChild()	Retourne un XmlWriter objet utilisé pour créer un ou plusieurs nœuds enfants à la fin de la liste des nœuds enfants du nœud actuel.
AppendChild(String)	Crée un nœud enfant à la fin de la liste des 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 des 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 des nœuds enfants du nœud actuel à l’aide des nœuds spécifiés XPathNavigator .
AppendChildElement(String, String, String, String)	Crée un nœud d’élément enfant à la fin de la liste des 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 dans les XPathNavigator éléments conformes au schéma XSD (XML Schema Definition Language) fourni.
Clone()	En cas de substitution dans une classe dérivée, crée une nouvelle XPathNavigator position au même nœud que celui-ci XPathNavigator.
ComparePosition(XPathNavigator)	Compare la position du courant XPathNavigator à la position de l’élément XPathNavigator spécifié.
Compile(String)	Compile une chaîne représentant une expression XPath et retourne un XPathExpression objet.
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 utilisé pour créer de XmlWriter nouveaux attributs sur l’élément actuel.
CreateNavigator()	Retourne une copie du XPathNavigator.
DeleteRange(XPathNavigator)	Supprime une plage de nœuds frères 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, IXmlNamespaceResolver)	Évalue l’expression XPath spécifiée et retourne le résultat typé, à l’aide de l’objet IXmlNamespaceResolver spécifié pour résoudre les préfixes d’espace de noms dans l’expression XPath.
Evaluate(String)	Évalue l’expression XPath spécifiée et retourne le résultat typé.
Evaluate(XPathExpression, XPathNodeIterator)	Utilise le contexte fourni pour évaluer le XPathExpressionrésultat et retourne le résultat typé.
Evaluate(XPathExpression)	Évalue le XPathExpression résultat typé et retourne le résultat typé.
GetAttribute(String, String)	Obtient la valeur de l’attribut avec le nom local et l’URI d’espace de noms spécifiés.
GetHashCode()	Sert 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 les espaces de noms dans l’étendue du nœud actuel.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
InsertAfter()	Retourne un XmlWriter objet utilisé pour créer un nœud frère après le nœud actuellement 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é à l’aide du 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 de l’objet XPathNavigator spécifié.
InsertBefore()	Retourne un XmlWriter objet utilisé pour créer un nœud frère avant le nœud actuellement 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é à l’aide du 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 le XPathNavigator fichier 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 spécifié XPathNavigator est un descendant du courant XPathNavigator.
IsSamePosition(XPathNavigator)	En cas de substitution dans une classe dérivée, détermine si le courant XPathNavigator est à la même position que celui spécifié XPathNavigator.
LookupNamespace(String)	Obtient l’URI d’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 à l’objet spécifié XPathExpression.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
MoveTo(XPathNavigator)	En cas de substitution dans une classe dérivée, déplace la XPathNavigator position à la même position que celle spécifiée XPathNavigator.
MoveToAttribute(String, String)	Déplace l’attribut XPathNavigator avec le nom local et l’URI d’espace de noms correspondants.
MoveToChild(String, String)	Déplace le XPathNavigator nœud enfant avec le nom local et l’URI d’espace de noms spécifiés.
MoveToChild(XPathNodeType)	Déplace le XPathNavigator nœud enfant du XPathNodeType nœud spécifié.
MoveToFirst()	Déplace le XPathNavigator nœud vers le premier nœud frère du nœud actuel.
MoveToFirstAttribute()	En cas de substitution dans une classe dérivée, déplace le XPathNavigator premier attribut du nœud actuel.
MoveToFirstChild()	En cas de substitution dans une classe dérivée, déplace le XPathNavigator nœud vers le premier nœud enfant du nœud actuel.
MoveToFirstNamespace()	Déplace le XPathNavigator premier nœud d’espace de noms du nœud actuel.
MoveToFirstNamespace(XPathNamespaceScope)	En cas de substitution dans une classe dérivée, déplace le XPathNavigator vers le premier nœud d’espace de noms qui correspond au XPathNamespaceScope spécifié.
MoveToFollowing(String, String, XPathNavigator)	Déplace l’élément XPathNavigator avec le nom local et l’URI d’espace de noms spécifiés, vers la limite spécifiée, dans l’ordre du document.
MoveToFollowing(String, String)	Déplace l’élément XPathNavigator avec le nom local et l’URI d’espace de noms spécifiés dans l’ordre du document.
MoveToFollowing(XPathNodeType, XPathNavigator)	Déplace l’élément XPathNavigator suivant de l’élément XPathNodeType spécifié vers la limite spécifiée, dans l’ordre du document.
MoveToFollowing(XPathNodeType)	Déplace l’élément XPathNavigator suivant de l’ordre XPathNodeType de document spécifié.
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 à la valeur spécifiée String.
MoveToNamespace(String)	Déplace le XPathNavigator nœud d’espace de noms avec le préfixe d’espace de noms spécifié.
MoveToNext()	En cas de substitution dans une classe dérivée, déplace le XPathNavigator nœud frère suivant du nœud actuel.
MoveToNext(String, String)	Déplace le XPathNavigator nœud frère suivant avec le nom local et l’URI d’espace de noms spécifiés.
MoveToNext(XPathNodeType)	Déplace le XPathNavigator nœud frère suivant du nœud actuel qui correspond au XPathNodeType nœud spécifié.
MoveToNextAttribute()	En cas de substitution dans une classe dérivée, déplace l’attribut XPathNavigator vers l’attribut suivant.
MoveToNextNamespace()	Déplace le XPathNavigator nœud d’espace de noms suivant.
MoveToNextNamespace(XPathNamespaceScope)	En cas de substitution dans une classe dérivée, déplace le XPathNavigator nœud d’espace de noms suivant correspondant à celui XPathNamespaceScope spécifié.
MoveToParent()	En cas de substitution dans une classe dérivée, déplace le XPathNavigator nœud parent du nœud actuel.
MoveToPrevious()	En cas de substitution dans une classe dérivée, déplace le XPathNavigator nœud frère précédent du nœud actuel.
MoveToRoot()	Déplace le XPathNavigator nœud racine auquel appartient le nœud actuel.
PrependChild()	Retourne un XmlWriter objet utilisé pour créer un nœud enfant au début de la liste des nœuds enfants du nœud actuel.
PrependChild(String)	Crée un nœud enfant au début de la liste des 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 à l’aide du contenu XML de l’objet XmlReader spécifié.
PrependChild(XPathNavigator)	Crée un nœud enfant au début de la liste des nœuds enfants du nœud actuel à l’aide des nœuds dans l’objet XPathNavigator spécifié.
PrependChildElement(String, String, String, String)	Crée un élément enfant au début de la liste des 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 XmlReader objet qui contient le nœud actuel et ses nœuds enfants.
ReplaceRange(XPathNavigator)	Remplace une plage de nœuds frères 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, IXmlNamespaceResolver)	Sélectionne un jeu de nœuds à l’aide de l’expression XPath spécifiée avec l’objet IXmlNamespaceResolver spécifié pour résoudre les préfixes d’espace de noms.
Select(String)	Sélectionne un jeu de nœuds à l’aide de l’expression XPath spécifiée.
Select(XPathExpression)	Sélectionne un jeu de nœuds à l’aide de l’élément spécifié XPathExpression.
SelectAncestors(String, String, Boolean)	Sélectionne tous les nœuds ancêtres du nœud actuel qui ont le nom local et 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 ont une correspondance XPathNodeType.
SelectChildren(String, String)	Sélectionne tous les nœuds enfants du nœud actuel qui ont le nom local et l’URI d’espace de noms spécifiés.
SelectChildren(XPathNodeType)	Sélectionne tous les nœuds enfants du nœud actuel qui ont la correspondance XPathNodeType.
SelectDescendants(String, String, Boolean)	Sélectionne tous les nœuds descendants du nœud actuel avec le nom local et l’URI d’espace de noms spécifiés.
SelectDescendants(XPathNodeType, Boolean)	Sélectionne tous les nœuds descendants du nœud actuel qui ont une correspondance XPathNodeType.
SelectSingleNode(String, IXmlNamespaceResolver)	Sélectionne un nœud unique dans l’objet XPathNavigator à l’aide de la requête XPath spécifiée avec l’objet IXmlNamespaceResolver spécifié pour résoudre les préfixes d’espace de noms.
SelectSingleNode(String)	Sélectionne un nœud unique dans l’utilisation XPathNavigator de la requête XPath spécifiée.
SelectSingleNode(XPathExpression)	Sélectionne un nœud unique dans l’objet XPathNavigator spécifié XPathExpression .
SetTypedValue(Object)	Définit la valeur typée du nœud actuel.
SetValue(String)	Définit la valeur du nœud actuel.
ToString()	Obtient la valeur de texte du nœud actuel.
ValueAs(Type, IXmlNamespaceResolver)	Obtient la valeur du nœud actuel comme Type spécifié, à l’aide de l’objet IXmlNamespaceResolver spécifié pour résoudre les préfixes d’espace de noms.
ValueAs(Type)	Retourne la valeur de l’élément comme type spécifié. (Hérité de XPathItem)
WriteSubtree(XmlWriter)	Diffuse le nœud actuel et ses nœuds enfants vers l’objet XmlWriter spécifié.

Implémentations d’interfaces explicites

Nom	Description
ICloneable.Clone()	Crée une copie de l’objet XPathNavigator .

Voir aussi

• IXPathNavigable
• XPathDocument
• XmlDocument
• XmlNode
• Traiter des données XML à l’aide du modèle de données XPath