XmlReader.ReadToFollowing メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定された要素が見つかるまで読み込みます。
オーバーロード
ReadToFollowing(String) |
指定された修飾名の要素が見つかるまで読み込みます。 |
ReadToFollowing(String, String) |
指定されたローカル名と名前空間 URI が見つかるまで要素を読み込みます。 |
ReadToFollowing(String)
指定された修飾名の要素が見つかるまで読み込みます。
public:
virtual bool ReadToFollowing(System::String ^ name);
public virtual bool ReadToFollowing (string name);
abstract member ReadToFollowing : string -> bool
override this.ReadToFollowing : string -> bool
Public Overridable Function ReadToFollowing (name As String) As Boolean
パラメーター
- name
- String
要素の限定名。
戻り値
一致する要素が見つかる場合は true
。それ以外の場合は false
になり、XmlReader がファイルの末尾に置かれます。
例外
先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。
パラメーターは空の文字列です。
注釈
このメソッドは、現在のノードから XPath 式を following::name
実行する場合と機能的に同等です。 XML ドキュメントで名前付き要素を簡単に検索できます。 指定した名前に一致する次の要素にリーダーを進め、一致する要素が見つかった場合に返します true
。 次の例を使用すると、リーダーは、前方読み取り中に、指定された要素の最初のインスタンスに読み取ります。
<!--"sample.xml"-->
<?xml version="1.0">
<items>
<item xmls="urn:1"/>
</items>
</xml>
XmlTextReader reader = newXmlTextReader("sample.xml");
reader.ReadToFollowing("item");
このメソッドは、すべてのノードの種類で呼び出すことができます。
適用対象
ReadToFollowing(String, String)
指定されたローカル名と名前空間 URI が見つかるまで要素を読み込みます。
public:
virtual bool ReadToFollowing(System::String ^ localName, System::String ^ namespaceURI);
public virtual bool ReadToFollowing (string localName, string namespaceURI);
abstract member ReadToFollowing : string * string -> bool
override this.ReadToFollowing : string * string -> bool
Public Overridable Function ReadToFollowing (localName As String, namespaceURI As String) As Boolean
パラメーター
- localName
- String
要素のローカル名。
- namespaceURI
- String
要素の名前空間 URI。
戻り値
一致する要素が見つかる場合は true
。それ以外の場合は false
になり、XmlReader がファイルの末尾に置かれます。
例外
先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。
両方のパラメーター値が null
です。
注釈
このメソッドは、現在のノードから XPath 式を following::name
実行する場合と機能的に同等です。 XML ドキュメントで名前付き要素を簡単に検索できます。 指定した名前に一致する次の要素にリーダーを進め、一致する要素が見つかった場合に返します true
。
<!--"sample.xml"-->
<?xml version="1.0">
<items>
<item xmls="urn:1"/>
</items>
</xml>
XmlTextReader reader = newXmlTextReader("sample.xml");
reader.ReadToFollowing("item", "urn:1");
このメソッドは、すべてのノードの種類で呼び出すことができます。