• Article

XmlReader.ReadToNextSibling Method (String)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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

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

Syntax

'Declaration
Public Overridable Function ReadToNextSibling ( _
    name As String _
) As Boolean

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.

Remarks

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.

Examples

Dim output As New StringBuilder()

Dim xmlString As String = _
    "<root>" & _
      "<item sale-item='true' productID='123456' colors='blue green black'>" & _
            "<price>9.95</price>" & _
        "</item>" & _
        "<item sale-item='false' productID='124390'>" & _
            "<price>5.95</price>" & _
        "</item>" & _
        "<item sale-item='true' productID='53298'>" & _
            "<price>12.95</price>" & _
        "</item>" & _
    "</root>"


Using reader As XmlReader = XmlReader.Create(New StringReader(xmlString))

    reader.ReadToDescendant("item")
    Do
        reader.MoveToAttribute("sale-item")
        Dim onSale As Boolean = reader.ReadContentAsBoolean()
        If onSale Then
            output.AppendLine(reader("productID"))
        End If
    Loop While reader.ReadToNextSibling("item")

    OutputTextBlock.Text = output.ToString()
End Using

StringBuilder output = new StringBuilder();

String xmlString =
    @"<root>
  <item sale-item='true' productID='123456' colors='blue green black'>
    <price>9.95</price>
  </item>
  <item sale-item='false' productID='124390'>
    <price>5.95</price>
  </item>
  <item sale-item='true' productID='53298'>
    <price>12.95</price>
  </item>
</root>";

using (XmlReader reader = XmlReader.Create(new StringReader(xmlString)))
{
    reader.ReadToDescendant("item");
    do
    {
        reader.MoveToAttribute("sale-item");
        Boolean onSale = reader.ReadContentAsBoolean();
        if (onSale)
        {
            output.AppendLine(reader["productID"]);
        }
    } while (reader.ReadToNextSibling("item"));

}

OutputTextBlock.Text = output.ToString();

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.