XmlTextReader.IsEmptyElement Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets a value indicating whether the current node is an empty element (for example, <MyElement/>).

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

Public Overrides ReadOnly Property IsEmptyElement As Boolean

Property Value

Type: System.Boolean

true if the current node is an element (NodeType equals XmlNodeType.Element) that ends with />; otherwise, false.


Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.

This property enables you to determine the difference between the following:

<item num="123"/> (IsEmptyElement is true).

<item num="123"> (IsEmptyElement is false, although element content is empty).

A corresponding EndElement node is not generated for empty elements.

IsEmptyElement simply reports whether or not the element in the source document had an end element tag.

The following example displays the text content of each element.

Option Strict
Option Explicit

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample

    Public Shared Sub Main()
        Dim reader As XmlTextReader = Nothing

            'Load the reader with the XML file.
            reader = New XmlTextReader("elems.xml")

            'Parse the XML and display the text content of each of the elements.
            While reader.Read()
                If reader.IsStartElement() Then
                    If reader.IsEmptyElement Then
                        Console.WriteLine("<{0}/>", reader.Name)
                        Console.Write("<{0}>" + " ", reader.Name)
                        reader.Read() 'Read the start tag.
                        If (reader.IsStartElement())  'Handle nested elements.
                          Console.Write("<{0}>", reader.Name)
                        End If
                        Console.WriteLine(reader.ReadString()) 'Read the text content of the element.
                    End If
                End If
            End While

            If Not (reader Is Nothing) Then
            End If
        End Try
    End Sub 'Main 
End Class 'Sample

The example uses the file, elems.xml, as input.

  <title>Pride And Prejudice</title>

.NET Framework
Available since 1.1
Return to top