Article
11/18/2011

XmlReader.ReadToFollowing Method (String)

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

Reads until an element with the specified qualified name is found.

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

Syntax

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

public virtual bool ReadToFollowing(
    string name
)

Parameters

name
Type: System.String
The qualified name of the element.

Return Value

Type: System.Boolean
true if a matching element is found; otherwise false and the XmlReader is in an end of file state.

Remarks

This method is functionally equivalent executing the following::name XPath expression from the current node. It provides a quick way to find a named element in the XML document. It advances the reader to the next following element that matches the specified name and returns true if a matching element is found.

This method can be called on all node types.

Examples

The following example uses the XmlReader methods to read the content of elements and attributes.

Dim output As StringBuilder = New StringBuilder()

Dim xmlString As String = _
    "<bookstore>" & _
            "<book genre='autobiography' publicationdate='1981-03-22' ISBN='1-861003-11-0'>" & _
                "<title>The Autobiography of Benjamin Franklin</title>" & _
                "<author>" & _
                    "<first-name>Benjamin</first-name>" & _
                    "<last-name>Franklin</last-name>" & _
                "</author> " & _
                "<price>8.99</price>" & _
            "</book>" & _
        "</bookstore>"

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

    reader.ReadToFollowing("book")
    reader.MoveToFirstAttribute()
    Dim genre As String = reader.Value
    output.AppendLine("The genre value: " + genre)

    reader.ReadToFollowing("title")
    output.AppendLine("Content of the title element: " + reader.ReadElementContentAsString())
End Using

OutputTextBlock.Text = output.ToString()

StringBuilder output = new StringBuilder();

String xmlString =
    @"<bookstore>
        <book genre='autobiography' publicationdate='1981-03-22' ISBN='1-861003-11-0'>
            <title>The Autobiography of Benjamin Franklin</title>
            <author>
                <first-name>Benjamin</first-name>
                <last-name>Franklin</last-name>
            </author>
            <price>8.99</price>
        </book>
    </bookstore>";

// Create an XmlReader
using (XmlReader reader = XmlReader.Create(new StringReader(xmlString)))
{
    reader.ReadToFollowing("book");
    reader.MoveToFirstAttribute();
    string genre = reader.Value;
    output.AppendLine("The genre value: " + genre);

    reader.ReadToFollowing("title");
    output.AppendLine("Content of the title element: " + reader.ReadElementContentAsString());
}

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.

Share via