XmlReader::ReadToNextSibling Method (String^)

 

Advances the XmlReader to the next sibling element with the specified qualified name.

Namespace:   System.Xml
Assembly:  System.Xml (in System.Xml.dll)

public:
virtual bool ReadToNextSibling(
	String^ name
)

Parameters

name
Type: System::String^

The qualified name of the sibling element you wish to move to.

Return Value

Type: System::Boolean

true if a matching sibling element is found; otherwise false. If a matching sibling element is not found, the XmlReader is positioned on the end tag (NodeType is XmlNodeType.EndElement) of the parent element.

Exception Condition
InvalidOperationException

An XmlReader method was called before a previous asynchronous operation finished. In this case, InvalidOperationException is thrown with the message “An asynchronous operation is already in progress.”

ArgumentException

The parameter is an empty string.

System_CAPS_noteNote

Do not call ReadToNextSibling when the XmlReader is an initial state (ReadState is Initial). You can call Read to advance the XmlReader and then call the ReadToNextSibling method.

The following example reads the ISBN attribute on each book node.

No code example is currently available or this language may not be supported.

Universal Windows Platform
Available since 8
.NET Framework
Available since 2.0
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: