Share via

XPathNavigator.MoveToFirstNamespace Méthode

  • Référence

Définition

Espace de noms:
System.Xml.XPath
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.XPath.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

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

Surcharges

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

public:
 abstract bool MoveToFirstNamespace(System::Xml::XPath::XPathNamespaceScope namespaceScope);
public abstract bool MoveToFirstNamespace (System.Xml.XPath.XPathNamespaceScope namespaceScope);
abstract member MoveToFirstNamespace : System.Xml.XPath.XPathNamespaceScope -> bool
Public MustOverride Function MoveToFirstNamespace (namespaceScope As XPathNamespaceScope) As Boolean

Paramètres

namespaceScope
XPathNamespaceScope

Valeur de XPathNamespaceScope décrivant la portée espace de noms.

Retours

Boolean

true si le XPathNavigator se déplace correctement vers le premier nœud d’espace de noms ; sinon, false. Si la valeur est false, c’est que la position du XPathNavigator est inchangée.

Remarques

la classe XPathNavigator retourne des nœuds d'espace de noms dans l'ordre inverse du document. Par conséquent, la méthode MoveToFirstNamespace se déplace essentiellement vers le dernier nœud d'espace de noms de la portée actuelle.

L’utilisation du fragment XML suivant comme exemple, si elle XPathNavigator est positionnée sur le data nœud, MoveToFirstNamespace se comporte de la manière suivante.

  • MoveToFirstNamespace(XPathNamespaceScope.All)se déplace vers l’un des nœuds d’espace de noms suivants : xmlns:c='C', , xmlns:a='A2', xmlns=''``xmlns:b='B'ou xmlns:xml='http://www.w3.org/XML/1998/namespace'.

  • MoveToFirstNamespace(XPathNamespaceScope.ExcludeXml)se déplace vers l’un des nœuds d’espace de noms suivants : xmlns:c='C', , xmlns:a='A2'``xmlns=''ou xmlns:b='B'.

  • MoveToFirstNamespace(XPathNamespaceScope.Local) se déplace vers le xmlns:c='C' nœud.

<root xmlns='urn:default' xmlns:a='A1' xmlns:b='B'>  
    <item xmlns='' xmlns:a='A2'>  
        <data xmlns:c='C' />  
    </item>  
</root>

Si la XPathNavigator valeur n’est pas actuellement positionnée sur un élément, cette méthode retourne false et la position de l’élément XPathNavigator ne change pas. Une fois le nœud d’espace XPathNavigator de noms déplacé, la Name propriété reflète le nom de l’espace de noms.

Lorsque le XPathNavigator nœud d’espace de noms est positionné sur un nœud d’espace de noms, les méthodes MoveToNextMoveToPrevious, et MoveToFirst ne sont pas applicables. Ces méthodes retournent false toujours et ne modifient pas la position du XPathNavigator. Au lieu de cela, vous pouvez appeler MoveToNextNamespace pour passer au nœud d’espace de noms suivant.

Une fois le XPathNavigator nœud d’espace de noms positionné sur un nœud d’espace de noms, appelez-le MoveToParent pour revenir au nœud d’élément.

Pour obtenir une définition de nœuds d’espace de noms, consultez la section 5.4 de la recommandation XPath (W3C XML Path Language).

Voir aussi

S’applique à

MoveToFirstNamespace()

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

public:
 bool MoveToFirstNamespace();
public bool MoveToFirstNamespace ();
member this.MoveToFirstNamespace : unit -> bool
Public Function MoveToFirstNamespace () As Boolean

Retours

Boolean

true si le XPathNavigator se déplace correctement vers le premier nœud d’espace de noms ; sinon, false. Si la valeur est false, c’est que la position du XPathNavigator est inchangée.

Remarques

la classe XPathNavigator retourne des nœuds d'espace de noms dans l'ordre inverse du document. Par conséquent, la méthode MoveToFirstNamespace se déplace essentiellement vers le dernier nœud d'espace de noms de la portée actuelle.

Une fois le nœud d’espace XPathNavigator de noms déplacé, la Name propriété reflète le nom de l’espace de noms.

Lorsque le XPathNavigator nœud d’espace de noms est positionné sur un nœud d’espace de noms, les méthodes MoveToNextMoveToPrevious, et MoveToFirst ne sont pas applicables. Ces méthodes retournent false toujours et ne modifient pas la position du XPathNavigator. Au lieu de cela, vous pouvez appeler MoveToNextNamespace pour passer au nœud d’espace de noms suivant.

Une fois le XPathNavigator nœud d’espace de noms positionné sur un nœud d’espace de noms, appelez-le MoveToParent pour revenir au nœud d’élément.

Pour obtenir une définition de nœuds d’espace de noms, consultez la section 5.4 de la recommandation XPath (W3C XML Path Language).

Voir aussi

S’applique à