Export (0) Print
Expand All

XPathNavigator.MoveToId Method

When overridden in a derived class, moves to the node that has an attribute of type ID whose value matches the specified String.

Namespace:  System.Xml.XPath
Assembly:  System.Xml (in System.Xml.dll)

public abstract bool MoveToId(
	string id
)

Parameters

id
Type: System.String

A String representing the ID value of the node to which you want to move.

Return Value

Type: System.Boolean
true if the XPathNavigator is successful moving; otherwise, false. If false, the position of the navigator is unchanged.

This method can be used to identify nodes by unique ID provided the source document explicitly declares attributes of type ID using a DTD.

For example, suppose the following XML data, <data><x a="a1"/></data>, was loaded using a DTD that included the following: <!ATTLIST x a ID #REQUIRED>.

If the XPathNavigator was positioned somewhere in the XML data, calling MoveToId("a1") positions the XPathNavigator on the element node x.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft