XPathNavigator.MoveToId(String) Method

Reference

Definition

Namespace:: System.Xml.XPath

Assemblies:: netstandard.dll, System.Xml.ReaderWriter.dll

Assembly:: System.Xml.XPath.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Source:: XPathNavigator.cs

Source:: XPathNavigator.cs

Source:: XPathNavigator.cs

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.

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.

Applies to

Product	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

Share via