Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

XPathNavigator, classe

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

Espace de noms :  System.Xml.XPath
Assembly :  System.Xml (dans System.Xml.dll)

public abstract class XPathNavigator : XPathItem, 
	ICloneable, IXPathNavigable, IXmlNamespaceResolver

Le type XPathNavigator expose les membres suivants.

  NomDescription
Méthode protégéeXPathNavigatorInitialise une nouvelle instance de la classe XPathNavigator.
Début

  NomDescription
Propriété publiqueBaseURIEn cas de substitution dans une classe dérivée, obtient l'URI de base du nœud actuel.
Propriété publiqueCanEditObtient une valeur indiquant si XPathNavigator peut modifier les données XML sous-jacentes.
Propriété publiqueHasAttributesObtient une valeur indiquant si le nœud actuel possède des attributs.
Propriété publiqueHasChildrenObtient une valeur indiquant si le nœud actuel possède des nœuds enfants.
Propriété publiqueInnerXmlObtient ou définit le balisage représentant les nœuds enfants du nœud actuel.
Propriété publiqueIsEmptyElementEn 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é publiqueIsNodeObtient une valeur indiquant si le nœud actuel représente un nœud XPath. (Substitue XPathItem.IsNode.)
Propriété publiqueLocalNameEn 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é publiqueNameEn cas de substitution dans une classe dérivée, obtient le nom qualifié du nœud actuel.
Propriété publiqueNamespaceURIEn cas de substitution dans une classe dérivée, obtient l'URI de l'espace de noms du nœud actuel.
Propriété publiqueNameTableEn cas de substitution dans une classe dérivée, obtient XmlNameTable de XPathNavigator.
Propriété publiqueMembre statiqueNavigatorComparerObtient un IEqualityComparer utilisé pour la comparaison d'égalité d'objets XPathNavigator.
Propriété publiqueNodeTypeEn cas de substitution dans une classe dérivée, obtient le XPathNodeType du nœud actuel.
Propriété publiqueOuterXmlObtient 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é publiquePrefixEn 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é publiqueSchemaInfoObtient les informations de schéma qui ont été assignées au nœud actuel à la suite de la validation du schéma.
Propriété publiqueTypedValueObtient le nœud actuel en tant qu'objet boxed du type .NET Framework le plus approprié. (Substitue XPathItem.TypedValue.)
Propriété publiqueUnderlyingObjectUtilisé 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é publiqueValueEn cas de substitution dans une classe dérivée, obtient la valeur string de l'élément. (Hérité de XPathItem.)
Propriété publiqueValueAsBooleanObtient la valeur du nœud actuel en tant que Boolean. (Substitue XPathItem.ValueAsBoolean.)
Propriété publiqueValueAsDateTimeObtient la valeur du nœud actuel en tant que DateTime. (Substitue XPathItem.ValueAsDateTime.)
Propriété publiqueValueAsDoubleObtient la valeur du nœud actuel en tant que Double. (Substitue XPathItem.ValueAsDouble.)
Propriété publiqueValueAsIntObtient la valeur du nœud actuel en tant que Int32. (Substitue XPathItem.ValueAsInt.)
Propriété publiqueValueAsLongObtient la valeur du nœud actuel en tant que Int64. (Substitue XPathItem.ValueAsLong.)
Propriété publiqueValueTypeObtient le nœud actuel Type du .NET Framework. (Substitue XPathItem.ValueType.)
Propriété publiqueXmlLangObtient la portée xml:lang pour le nœud actuel.
Propriété publiqueXmlTypeObtient les informations XmlSchemaType pour le nœud actuel. (Substitue XPathItem.XmlType.)
Début

  NomDescription
Méthode publiqueAppendChild()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 publiqueAppendChild(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 publiqueAppendChild(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 publiqueAppendChild(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 publiqueAppendChildElementCré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 publiqueCheckValidityVérifie que les données XML du XPathNavigator sont conformes au schéma XSD (XML Schema Definition) fourni.
Méthode publiqueCloneEn cas de substitution dans une classe dérivée, crée un XPathNavigator positionné au même nœud que ce XPathNavigator.
Méthode publiqueComparePositionCompare la position du XPathNavigator en cours avec la position du XPathNavigator spécifié.
Méthode publiqueCompileCompile une chaîne représentant une expression XPath, puis retourne un objet XPathExpression.
Méthode publiqueCreateAttributeCré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 publiqueCreateAttributesRetourne un objet XmlWriter permettant de créer des attributs sur l'élément actuel.
Méthode publiqueCreateNavigatorRetourne une copie de XPathNavigator.
Méthode publiqueDeleteRangeSupprime une plage de nœuds frères allant du nœud actuel au nœud spécifié.
Méthode publiqueDeleteSelfSupprime le nœud actuel et ses nœuds enfants.
Méthode publiqueEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode publiqueEvaluate(String)Évalue l'expression XPath spécifiée et retourne le résultat typé.
Méthode publiqueEvaluate(XPathExpression)Évalue XPathExpression spécifiée et retourne le résultat typé.
Méthode publiqueEvaluate(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 publiqueEvaluate(XPathExpression, XPathNodeIterator)Utilise le contexte fourni pour évaluer le XPathExpression et retourne le résultat typé.
Méthode protégéeFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiqueGetAttributeObtient la valeur de l'attribut avec le nom local et l'URI de l'espace de noms spécifiés.
Méthode publiqueGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiqueGetNamespaceRetourne la valeur du nœud d'espace de noms correspondant au nom local spécifié.
Méthode publiqueGetNamespacesInScopeRetourne tous les espaces de noms dans la portée du nœud actuel.
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueInsertAfter()Retourne un objet XmlWriter permettant de créer un nœud frère après le nœud sélectionné.
Méthode publiqueInsertAfter(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 publiqueInsertAfter(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 publiqueInsertAfter(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 publiqueInsertBefore()Retourne un objet XmlWriter permettant de créer un nœud frère avant le nœud sélectionné.
Méthode publiqueInsertBefore(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 publiqueInsertBefore(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 publiqueInsertBefore(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 publiqueInsertElementAfterCré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 publiqueInsertElementBeforeCré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 publiqueIsDescendantDétermine si le XPathNavigator spécifié est un descendant du XPathNavigator en cours.
Méthode publiqueIsSamePositionEn 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 publiqueLookupNamespaceObtient l'URI de l'espace de noms du préfixe spécifié.
Méthode publiqueLookupPrefixObtient le préfixe déclaré pour l'URI d'espace de noms spécifié.
Méthode publiqueMatches(String)Détermine si le nœud actuel correspond à l'expression XPath spécifiée.
Méthode publiqueMatches(XPathExpression)Détermine si le nœud actuel correspond au XPathExpression spécifié.
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode publiqueMoveToEn 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 publiqueMoveToAttributeDéplace le XPathNavigator vers l'attribut avec le nom local et l'URI d'espace de noms spécifiés.
Méthode publiqueMoveToChild(XPathNodeType)Déplace le XPathNavigator vers le nœud enfant du XPathNodeType spécifié.
Méthode publiqueMoveToChild(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 publiqueMoveToFirstDéplace XPathNavigator vers le premier nœud frère du nœud actuel.
Méthode publiqueMoveToFirstAttributeEn cas de substitution dans une classe dérivée, déplace XPathNavigator vers le premier attribut du nœud actuel.
Méthode publiqueMoveToFirstChildEn cas de substitution dans une classe dérivée, déplace XPathNavigator vers le premier attribut enfant du nœud actuel.
Méthode publiqueMoveToFirstNamespace()Déplace XPathNavigator vers le premier nœud d'espace du nœud actuel.
Méthode publiqueMoveToFirstNamespace(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 publiqueMoveToFollowing(XPathNodeType)Déplace le XPathNavigator vers l'élément suivant du XPathNodeType spécifié dans l'ordre du document.
Méthode publiqueMoveToFollowing(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 publiqueMoveToFollowing(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 publiqueMoveToFollowing(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 publiqueMoveToIdEn 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 publiqueMoveToNamespaceDéplace XPathNavigator vers le nœud d'espace de noms correspondant au préfixe d'espace de noms.
Méthode publiqueMoveToNext()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 publiqueMoveToNext(XPathNodeType)Déplace le XPathNavigator vers le nœud frère suivant du nœud actuel qui correspond au XPathNodeType spécifié.
Méthode publiqueMoveToNext(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 publiqueMoveToNextAttributeEn cas de substitution dans une classe dérivée, déplace le XPathNavigator vers l'attribut suivant.
Méthode publiqueMoveToNextNamespace()Déplace XPathNavigator vers le nœud d'espace de noms suivant.
Méthode publiqueMoveToNextNamespace(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 publiqueMoveToParentEn cas de substitution dans une classe dérivée, déplace XPathNavigator vers le nœud parent du nœud actuel.
Méthode publiqueMoveToPreviousEn 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 publiqueMoveToRootDéplace XPathNavigator vers le nœud racine auquel le nœud actuel appartient.
Méthode publiquePrependChild()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 publiquePrependChild(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 publiquePrependChild(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 publiquePrependChild(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 publiquePrependChildElementCré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 publiqueReadSubtreeRetourne un objet XmlReader qui contient le nœud actuel et ses nœuds enfants.
Méthode publiqueReplaceRangeRemplace une plage de nœuds frères allant du nœud actuel au nœud spécifié.
Méthode publiqueReplaceSelf(String)Remplace le nœud actuel par le contenu de la chaîne spécifiée.
Méthode publiqueReplaceSelf(XmlReader)Remplace le nœud actuel par le contenu de l'objet XmlReader spécifié.
Méthode publiqueReplaceSelf(XPathNavigator)Remplace le nœud actuel par le contenu de l'objet XPathNavigator spécifié.
Méthode publiqueSelect(String)Sélectionne un ensemble de nœuds à l'aide de l'expression XPath spécifiée.
Méthode publiqueSelect(XPathExpression)Sélectionne un ensemble de nœuds à l'aide du XPathExpression spécifié.
Méthode publiqueSelect(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 publiqueSelectAncestors(XPathNodeType, Boolean)Sélectionne tous les nœuds ancêtres du nœud actuel qui possèdent un XPathNodeType correspondant.
Méthode publiqueSelectAncestors(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 publiqueSelectChildren(XPathNodeType)Sélectionne tous les nœuds enfants du nœud actuel dotés du XPathNodeType correspondant.
Méthode publiqueSelectChildren(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 publiqueSelectDescendants(XPathNodeType, Boolean)Sélectionne tous les nœuds descendants du nœud actuel qui possèdent un XPathNodeType correspondant.
Méthode publiqueSelectDescendants(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 publiqueSelectSingleNode(String)Sélectionne un nœud dans XPathNavigator à l'aide de la requête XPath spécifiée.
Méthode publiqueSelectSingleNode(XPathExpression)Sélectionne un nœud dans XPathNavigator à l'aide de l'objet XPathExpression spécifiée.
Méthode publiqueSelectSingleNode(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 publiqueSetTypedValueDéfinit la valeur typée du nœud actuel.
Méthode publiqueSetValueDéfinit la valeur du nœud actuel.
Méthode publiqueToStringObtient le texte du nœud actuel. (Substitue Object.ToString().)
Méthode publiqueValueAs(Type)Retourne la valeur de l'élément comme type spécifié. (Hérité de XPathItem.)
Méthode publiqueValueAs(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 publiqueWriteSubtreeTransmet en continu le nœud actuel et ses nœuds enfants à l'objet XmlWriter spécifié.
Début

  NomDescription
Implémentation d'interface expliciteMéthode privéeICloneable.CloneCrée une nouvelle copie de l'objet d' XPathNavigator .
Début

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 :

.NET Framework

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

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

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.

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.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft