XmlReader.ReadToNextSibling メソッド

定義

名前空間:

System.Xml

アセンブリ:

System.Xml.ReaderWriter.dll

アセンブリ:

System.Xml.dll

アセンブリ:

netstandard.dll

XmlReader を次に一致する兄弟要素に進めます。

オーバーロード

ReadToNextSibling(String)	指定された修飾名を使用して XmlReader を次の兄弟要素に進めます。
ReadToNextSibling(String, String)	指定されたローカル名と名前空間 URI を使用して、XmlReader を次の兄弟要素に進めます。

ReadToNextSibling(String)

指定された修飾名を使用して XmlReader を次の兄弟要素に進めます。

C#

public virtual bool ReadToNextSibling (string name);

パラメーター

name

String

移動先となる兄弟要素の修飾名。

戻り値

Boolean

一致する兄弟要素が見つかった場合は true。それ以外の場合は false。 一致する兄弟要素が見つからない場合、XmlReader が親要素の終了タグ (NodeType が XmlNodeType.EndElement) に配置されます。

例外

InvalidOperationException

先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。

ArgumentException

パラメーターは空の文字列です。

例

次の例では、各ブック ノードの ISBN 属性を読み取ります。

C#

using (XmlReader reader = XmlReader.Create("books.xml")) {
    reader.ReadToFollowing("book");
    do {
       Console.WriteLine("ISBN: {0}", reader.GetAttribute("ISBN"));
    } while (reader.ReadToNextSibling("book"));
}

注釈

注意

初期状態ReadState (is) の場合XmlReaderはInitial呼び出ReadToNextSiblingさないでください。 メソッドを事前XmlReaderに呼び出Readしてから呼び出ReadToNextSiblingすことができます。

ReadToNextSibling(String, String)

指定されたローカル名と名前空間 URI を使用して、XmlReader を次の兄弟要素に進めます。

C#

public virtual bool ReadToNextSibling (string localName, string namespaceURI);

パラメーター

localName

String

移動先となる兄弟要素のローカル名。

namespaceURI

String

移動先となる兄弟要素の名前空間 URI。

戻り値

Boolean

一致する兄弟要素が見つかった場合は true。それ以外の場合は false。 一致する兄弟要素が見つからない場合、XmlReader が親要素の終了タグ (NodeType が XmlNodeType.EndElement) に配置されます。

例外

InvalidOperationException

先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。

ArgumentNullException

両方のパラメーター値が null です。

注釈

注意

初期状態ReadState (is) の場合XmlReaderはInitial呼び出ReadToNextSiblingさないでください。 メソッドを事前XmlReaderに呼び出Readしてから呼び出ReadToNextSiblingすことができます。