XPathNavigator.MoveToFirstNamespace Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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'
, orxmlns: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=''
, orxmlns:b='B'
.MoveToFirstNamespace(XPathNamespaceScope.Local)
moves to thexmlns: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.