XPathNavigator.MoveToId(String) Metoda

Definicja

Gdy jest zastępowany w klasie pochodnej, przenosi do węzła, który ma atrybut typu ID , którego wartość pasuje do określonego String.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

Parametry

id
String

String reprezentujący wartość identyfikatora węzła, do którego chcesz przenieść.A String representing the ID value of the node to which you want to move.

Zwraca

true w przypadku pomyślnego przeniesienia XPathNavigator; w przeciwnym razie false.true if the XPathNavigator is successful moving; otherwise, false. Jeśli false, pozycja nawigatora nie zmienia się.If false, the position of the navigator is unchanged.

Uwagi

Ta metoda może służyć do identyfikowania węzłów według unikatowych ID pod warunkiem, że dokument źródłowy jawnie deklaruje atrybuty typu ID przy użyciu DTD.This method can be used to identify nodes by unique ID provided the source document explicitly declares attributes of type ID using a DTD.

Załóżmy na przykład, że następujące dane XML <data><x a="a1"/></data>, zostały załadowane przy użyciu DTD, który zawiera następujące elementy: <!ATTLIST x a ID #REQUIRED>.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>.

Jeśli XPathNavigator została umieszczona gdzieś w danych XML, wywoływanie MoveToId("a1") położenia XPathNavigator w węźle elementu x.If the XPathNavigator was positioned somewhere in the XML data, calling MoveToId("a1") positions the XPathNavigator on the element node x.

Dotyczy