• Article

XmlReader.IsStartElement Method (String)

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

Calls MoveToContent and tests if the current content node is a start tag or empty element tag and if the Name property of the element found matches the given argument.

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

Syntax

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

public virtual bool IsStartElement(
    string name
)

Parameters

  • name
    Type: System.String
    The string matched against the Name property of the element found.

Return Value

Type: System.Boolean
true if the resulting node is an element and the Name property matches the specified string. false if a node type other than XmlNodeType.Element was found or if the element Name property does not match the specified string.

Exceptions

Exception Condition
XmlException

Incorrect XML is encountered in the input stream.

Remarks

This method skips white space, comments, and processing instructions until the reader is positioned on a content node. The method then tests if the current node is an element.

Examples

Dim output As New StringBuilder()

Dim xmlString As String = _
        "<book>" & _
            "<title>Pride And Prejudice</title>" & _
            "<price>19.95</price>" & _
            "<misc/>" & _
        "</book>"

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

    ' Parse the file and display each price node.
    While reader.Read()
        If reader.IsStartElement("price") Then
            output.Append(reader.ReadInnerXml())
        End If
    End While
End Using

OutputTextBlock.Text = output.ToString()


StringBuilder output = new StringBuilder();

String xmlString =
    @"<book>
      <title>Pride And Prejudice</title>
      <price>19.95</price>
      <misc/>
  </book>";

// Create an XmlReader
using (XmlReader reader = XmlReader.Create(new StringReader(xmlString)))
{
    // Parse the file and display each price node.
    while (reader.Read())
    {
        if (reader.IsStartElement("price"))
        {
            output.Append(reader.ReadInnerXml());
        }
    }
}
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.