Export (0) Print
Expand All

XmlValidatingReader.IsEmptyElement Property

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)

'Declaration
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.

NoteNote

The XmlValidatingReader class is obsolete in .NET Framework 2.0. You can create a validating XmlReader instance by using the XmlReaderSettings class and the Create method. For more information, see the Remarks section of the XmlReader reference page.

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.

If default content has been added to an element due to schema validation, IsEmptyElement still returns true. It has no bearing on whether or not the element has a default value. In other words, 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.

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample

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

      Try 
         'Implement the readers.
         txtreader = New XmlTextReader("elems.xml")
         reader = New XmlValidatingReader(txtreader)

         '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)
               Else
                  Console.Write("<{0}> ", reader.Name)
                  reader.Read() 'Read the start tag.
                  If (reader.IsStartElement())  'Handle nested elements.
                    Console.WriteLine()
                    Console.Write("<{0}>", reader.Name)
                  End If
                  Console.WriteLine(reader.ReadString()) 'Read the text content of the element.
               End If 
            End If 
         End While       

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

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

<book>
  <title>Pride And Prejudice</title>
  <price>19.95</price>
  <misc/>
</book>

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft