XPathNavigator.MoveToId メソッド

指定した文字列と値が一致する型 ID の属性を持つノードへ移動します。

Public MustOverride Function MoveToId( _
   ByVal id As String _) As Boolean
[C#]
public abstract bool MoveToId(stringid);
[C++]
public: virtual bool MoveToId(String* id) = 0;
[JScript]
public abstract function MoveToId(
   id : String) : Boolean;

パラメータ

• id
  移動先のノードの ID 値を表す文字列。この引数は、最小単位に分割する必要はありません。

戻り値

正常に移動した場合は true 。それ以外の場合は false 。 false の場合、ナビゲータの位置は変更されません。

メモ   ナビゲータが XmlDataDocument に実装されている場合、このメソッドは必ず false を返し、ナビゲータの位置は変更されません。

解説

ソース ドキュメントで DTD を使用して型 ID の属性を明示的に宣言している場合は、このメソッドを使用して、一意の ID でノードを識別できます。

たとえば、XML データ <data><x a="a1"/></data> が、 <!ATTLIST x a ID #REQUIRED> を含む DTD を使用して読み込まれたとします。

ナビゲータが XML データ内に配置されている場合、 MoveToId("a1") を呼び出すと、そのナビゲータは要素ノード x に配置されます。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

XPathNavigator クラス | XPathNavigator メンバ | System.Xml.XPath 名前空間