XPathNavigator.MoveToFirstNamespace Méthode

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

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

• MoveToNextNamespace()
• GetNamespace(String)
• MoveToNamespace(String)

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

• MoveToNextNamespace()
• GetNamespace(String)
• MoveToNamespace(String)