XPathNavigator.MoveToId(String) Method

Definition

Namespace:

System.Xml.XPath

Assembly:

System.Xml.ReaderWriter.dll

Source:

XPathNavigator.cs

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

public:
 abstract bool MoveToId(System::String ^ id);

public abstract bool MoveToId (string id);

abstract member MoveToId : string -> bool

Public MustOverride Function MoveToId (id As String) As Boolean

Parameters

id

String

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

Returns

Boolean

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

Remarks

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.