Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

XmlNodeReader::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)

public:
virtual property bool IsEmptyElement {
	bool get () override;
}

Property Value

Type: System::Boolean
true if the current node is an element (NodeType equals XmlNodeType.Element) and it ends with />; otherwise, false.

NoteNote

In the .NET Framework 2.0, the recommended practice is to create XmlReader instances using the XmlReaderSettings class and the Create method. This allows you to take full advantage of all the new features introduced in the .NET Framework. For more information, see the Remarks section in 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.

The following example displays the text content of each element.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlNodeReader^ reader = nullptr;
   try
   {

      //Create and load the XML document.
      XmlDocument^ doc = gcnew XmlDocument;
      doc->LoadXml( "<book>" 
      "<title>Pride And Prejudice</title>" 
      "<price>19.95</price>" 
      "<misc/>" 
      "</book>" );

      //Load the XmlNodeReader 
      reader = gcnew XmlNodeReader( doc );

      //Parse the XML and display the text content of each of the elements. 
      while ( reader->Read() )
      {
         if ( reader->IsStartElement() )
         {
            if ( reader->IsEmptyElement )
                        Console::WriteLine( "<{0}/>", reader->Name );
            else
            {
               Console::Write( "<{0}> ", reader->Name );
               reader->Read(); //Read the start tag. 
               if ( reader->IsStartElement() )

               //Handle nested elements.
               Console::Write( "\r\n<{0}>", reader->Name );
               Console::WriteLine( reader->ReadString() ); //Read the text content of the element.
            }
         }
      }
   }
   finally
   {
      if ( reader != nullptr )
            reader->Close();
   }

}

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0
Show:
© 2015 Microsoft