Edit

Share via


XPathNavigator.MoveToFirstNamespace Method

Definition

Moves the XPathNavigator to the first namespace node of the current node.

Overloads

MoveToFirstNamespace(XPathNamespaceScope)

When overridden in a derived class, moves the XPathNavigator to the first namespace node that matches the XPathNamespaceScope specified.

MoveToFirstNamespace()

Moves the XPathNavigator to first namespace node of the current node.

MoveToFirstNamespace(XPathNamespaceScope)

Source:
XPathNavigator.cs
Source:
XPathNavigator.cs
Source:
XPathNavigator.cs

When overridden in a derived class, moves the XPathNavigator to the first namespace node that matches the XPathNamespaceScope specified.

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

Parameters

namespaceScope
XPathNamespaceScope

An XPathNamespaceScope value describing the namespace scope.

Returns

true if the XPathNavigator is successful moving to the first namespace node; otherwise, false. If false, the position of the XPathNavigator is unchanged.

Remarks

The XPathNavigator class returns namespace nodes in reverse document order. Therefore, MoveToFirstNamespace essentially moves to the last namespace node in the current scope.

Using the following XML fragment as an example, if the XPathNavigator is positioned on the data node, MoveToFirstNamespace behaves in the following manner.

  • MoveToFirstNamespace(XPathNamespaceScope.All) moves to one of the following namespace nodes: xmlns:c='C', xmlns:a='A2', xmlns='', xmlns:b='B', or xmlns:xml='http://www.w3.org/XML/1998/namespace'.

  • MoveToFirstNamespace(XPathNamespaceScope.ExcludeXml) moves to one of the following namespace nodes: xmlns:c='C', xmlns:a='A2', xmlns='', or xmlns:b='B'.

  • MoveToFirstNamespace(XPathNamespaceScope.Local) moves to the xmlns:c='C' node.

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

If the XPathNavigator is not currently positioned on an element, this method returns false and the position of the XPathNavigator does not change. After the XPathNavigator has been moved to the namespace node, the Name property reflects the name of the namespace.

When the XPathNavigator is positioned on a namespace node, the methods MoveToNext, MoveToPrevious, and MoveToFirst are not applicable. These methods always return false and do not change the position of the XPathNavigator. Rather, you can call MoveToNextNamespace to move to the next namespace node.

After the XPathNavigator is positioned on an namespace node, call MoveToParent to move back to the element node.

For a definition of namespace nodes, see section 5.4 of the W3C XML Path Language (XPath) recommendation.

See also

Applies to

MoveToFirstNamespace()

Source:
XPathNavigator.cs
Source:
XPathNavigator.cs
Source:
XPathNavigator.cs

Moves the XPathNavigator to first namespace node of the current node.

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

Returns

true if the XPathNavigator is successful moving to the first namespace node; otherwise, false. If false, the position of the XPathNavigator is unchanged.

Remarks

The XPathNavigator class returns namespace nodes in reverse document order. Therefore, MoveToFirstNamespace essentially moves to the last namespace node in the current scope.

After the XPathNavigator has been moved to the namespace node, the Name property reflects the name of the namespace.

When the XPathNavigator is positioned on a namespace node, the methods MoveToNext, MoveToPrevious, and MoveToFirst are not applicable. These methods always return false and do not change the position of the XPathNavigator. Rather, you can call MoveToNextNamespace to move to the next namespace node.

After the XPathNavigator is positioned on an namespace node, call MoveToParent to move back to the element node.

For a definition of namespace nodes, see section 5.4 of the W3C XML Path Language (XPath) recommendation.

See also

Applies to