XmlReader.ReadToNextSibling XmlReader.ReadToNextSibling XmlReader.ReadToNextSibling XmlReader.ReadToNextSibling Method

定義

XmlReader を次に一致する兄弟要素に進めます。Advances the XmlReader to the next matching sibling element.

オーバーロード

ReadToNextSibling(String) ReadToNextSibling(String) ReadToNextSibling(String) ReadToNextSibling(String)

指定された修飾名を使用して XmlReader を次の兄弟要素に進めます。Advances the XmlReader to the next sibling element with the specified qualified name.

ReadToNextSibling(String, String) ReadToNextSibling(String, String) ReadToNextSibling(String, String) ReadToNextSibling(String, String)

指定されたローカル名と名前空間 URI を使用して、XmlReader を次の兄弟要素に進めます。Advances the XmlReader to the next sibling element with the specified local name and namespace URI.

ReadToNextSibling(String) ReadToNextSibling(String) ReadToNextSibling(String) ReadToNextSibling(String)

指定された修飾名を使用して XmlReader を次の兄弟要素に進めます。Advances the XmlReader to the next sibling element with the specified qualified name.

public:
 virtual bool ReadToNextSibling(System::String ^ name);
public virtual bool ReadToNextSibling (string name);
abstract member ReadToNextSibling : string -> bool
override this.ReadToNextSibling : string -> bool
Public Overridable Function ReadToNextSibling (name As String) As Boolean

パラメーター

name
String String String String

移動先となる兄弟要素の修飾名。The qualified name of the sibling element you wish to move to.

戻り値

一致する兄弟要素が見つかった場合は true。それ以外の場合は falsetrue if a matching sibling element is found; otherwise false. 一致する兄弟要素が見つからない場合、XmlReader が親要素の終了タグ (NodeTypeXmlNodeType.EndElement) に配置されます。If a matching sibling element is not found, the XmlReader is positioned on the end tag (NodeType is XmlNodeType.EndElement) of the parent element.

例外

先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。An XmlReader method was called before a previous asynchronous operation finished. この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

パラメーターは空の文字列です。The parameter is an empty string.

次の例では、各 book ノードの ISBN 属性を読み取ります。The following example reads the ISBN attribute on each book node.

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

注釈

注意

が初期状態ReadToNextSibling ( XmlReader ReadStateInitial) の場合は、を呼び出さないでください。Do not call ReadToNextSibling when the XmlReader is an initial state (ReadState is Initial). を呼び出しReadてをXmlReader進め、 ReadToNextSiblingメソッドを呼び出すことができます。You can call Read to advance the XmlReader and then call the ReadToNextSibling method.

ReadToNextSibling(String, String) ReadToNextSibling(String, String) ReadToNextSibling(String, String) ReadToNextSibling(String, String)

指定されたローカル名と名前空間 URI を使用して、XmlReader を次の兄弟要素に進めます。Advances the XmlReader to the next sibling element with the specified local name and namespace URI.

public:
 virtual bool ReadToNextSibling(System::String ^ localName, System::String ^ namespaceURI);
public virtual bool ReadToNextSibling (string localName, string namespaceURI);
abstract member ReadToNextSibling : string * string -> bool
override this.ReadToNextSibling : string * string -> bool
Public Overridable Function ReadToNextSibling (localName As String, namespaceURI As String) As Boolean

パラメーター

localName
String String String String

移動先となる兄弟要素のローカル名。The local name of the sibling element you wish to move to.

namespaceURI
String String String String

移動先となる兄弟要素の名前空間 URI。The namespace URI of the sibling element you wish to move to.

戻り値

一致する兄弟要素が見つかった場合は true。それ以外の場合は falsetrue if a matching sibling element is found; otherwise, false. 一致する兄弟要素が見つからない場合、XmlReader が親要素の終了タグ (NodeTypeXmlNodeType.EndElement) に配置されます。If a matching sibling element is not found, the XmlReader is positioned on the end tag (NodeType is XmlNodeType.EndElement) of the parent element.

例外

先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。An XmlReader method was called before a previous asynchronous operation finished. この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

両方のパラメーター値が null です。Both parameter values are null.

注釈

注意

が初期状態ReadToNextSibling ( XmlReader ReadStateInitial) の場合は、を呼び出さないでください。Do not call ReadToNextSibling when the XmlReader is an initial state (ReadState is Initial). を呼び出しReadてをXmlReader進め、 ReadToNextSiblingメソッドを呼び出すことができます。You can call Read to advance the XmlReader and then call the ReadToNextSibling method.

適用対象