Click here to Skip to main content
65,938 articles
CodeProject is changing. Read more.
Articles
(untagged)

Loading and Saving a TreeView control to an XML file using XmlTextWriter and XmlTextReader

0.00/5 (No votes)
17 Feb 2006 1  
Demonstrates how to serialize and de-serialize the contents of System.Windows.Forms.TreeView control from an XML file using forward only, non-cached XmlTextReader and XmlTextWriter.

Introduction

The purpose of this article is to demonstrate the saving and loading of System.Windows.Forms.TreeView control from an XML file. XmlTextReader and XmlTextWriter of System.Xml namespace are used for reading and generating XML files respectively. It also demonstrates a simple XML file viewer using a TreeView control.

Getting started

The real functionality is enclosed in a class called TreeViewSerializer. It has two main responsibilities:

  1. Saving the TreeView to a specified XML file.
  2. Loading the TreeView from any specified XML file.

The structure of an XML file used for serializing a TreeView is quite simple. Following is a sample XML file included with the attached project:

<?xml version="1.0" encoding="us-ascii" ?> 
<TreeView>
   <node text="Asia" imageindex="0">
      <node text="China" imageindex="-1" tag="Largest Population">
          <node text="Beijing" imageindex="-1" /></node>
      <node text="Pakistan" imageindex="4" /> 
      <node text="India" imageindex="5" /> 
      <node text="Srilanka" imageindex="6" /> 
   </node>
   <node text="Europe" imageindex="1">
      <node text="Germany" imageindex="6" /> 
      </node>
   <node text="America" imageindex="2" /> 
   <node text="Africa" imageindex="3" /> 
</TreeView>

After the XML declaration, all the nodes are enclosed in a TreeView tag. The TreeView tag may contain multiple node tags. The node tag can also contain other node tags. Each node tag can have three attributes:

  1. Text
  2. ImageIndex
  3. Tag

I have serialized the above three attributes of System.Windows.Forms.TreeNode object, it can be easily extended to include other attributes.

XmlNodeTag, XmlNodeTextAtt, XmlNodeTagAtt and XmlNodeImageIndexAtt are the constants defined in TreeViewSerializer class:

// Xml tag for node, e.g. 'node' in case of <node></node>

private const string XmlNodeTag = "node";

// Xml attributes for node e.g. <node text="Asia" tag="" 

// imageindex="1"></node>

private const string XmlNodeTextAtt = "text";
private const string XmlNodeTagAtt = "tag";
private const string XmlNodeImageIndexAtt = "imageindex";

Loading TreeView from XML � Deserialization

The deserialization is performed by the DeserializeTreeView method which uses XmlTextReader to parse through the XML document and fill the TreeView object. Following is the definition of DeserializeTreeView method:

public void DeserializeTreeView(TreeView treeView, string fileName)
{
   XmlTextReader reader = null;
   try
   {
        // disabling re-drawing of treeview till all nodes are added

        treeView.BeginUpdate();    
        reader = new XmlTextReader(fileName);
        TreeNode parentNode = null;
        while (reader.Read())
        {
             if (reader.NodeType == XmlNodeType.Element)
             {      
                  if (reader.Name == XmlNodeTag)
                  {
                       TreeNode newNode = new TreeNode();
                       bool isEmptyElement = reader.IsEmptyElement;
                
                       // loading node attributes

                       int attributeCount = reader.AttributeCount;
                       if (attributeCount > 0)
                       {
                          for (int i = 0; i < attributeCount; i++)
                          {
                              reader.MoveToAttribute(i);
                              SetAttributeValue(newNode, 
                                           reader.Name, reader.Value);
                          }        
                       }
                       // add new node to Parent Node or TreeView

                       if(parentNode != null)
                          parentNode.Nodes.Add(newNode);
                       else
                          treeView.Nodes.Add(newNode);
                
                       // making current node 'ParentNode' if its not empty

                       if (!isEmptyElement)
                       {
                          parentNode = newNode;
                       }
                  }                          
             }
             // moving up to in TreeView if end tag is encountered

             else if (reader.NodeType == XmlNodeType.EndElement)
             {
                  if (reader.Name == XmlNodeTag)
                  {
                           parentNode = parentNode.Parent;
                  }
             }
             else if (reader.NodeType == XmlNodeType.XmlDeclaration)
             { 
                  //Ignore Xml Declaration                    

             }
             else if (reader.NodeType == XmlNodeType.None)
             {
                  return;
             }
             else if (reader.NodeType == XmlNodeType.Text)
             {
                  parentNode.Nodes.Add(reader.Value);
             }
    
        }
   }
   finally
   {
        // enabling redrawing of treeview after all nodes are added

        treeView.EndUpdate();      
        reader.Close(); 
   }
}

As XmlTextReader parses through the XML document, appropriate actions are taken depending on the NodeType. If the NodeType is Element, a new TreeNode is created and its properties are set using the XML node attributes. The ParentNode is set to the new TreeNode in case of non-empty elements so that its child nodes are deserialized. If an EndElement is encountered, the ParentNode is set to the parent of the current parent node indicating that all the child nodes of the current node are deserialized.

For setting the Text, Tag and ImageIndex properties of a TreeNode, the SetAttributeValue method is called. It has the following implementation:

  /// <summary>

  /// Used by Deserialize method for setting properties of 

  /// TreeNode from xml node attributes

  /// </summary>

  private void SetAttributeValue(TreeNode node, 
                     string propertyName, string value)
  {
       if (propertyName == XmlNodeTextAtt)
       {                
            node.Text = value;    
       }
       else if (propertyName == XmlNodeImageIndexAtt) 
       {
            node.ImageIndex = int.Parse(value);
       }
       else if (propertyName == XmlNodeTagAtt)
       {
            node.Tag = value;
       }  
  }

Saving TreeView � Serialization

The SerializeTreeView saves the System.Windows.Forms.TreeView to the specified file. Following is the method definition:

public void SerializeTreeView(TreeView treeView, string fileName) 
  {
       XmlTextWriter textWriter = new XmlTextWriter(fileName, 
                                     System.Text.Encoding.ASCII);
       // writing the xml declaration tag

       textWriter.WriteStartDocument();
       //textWriter.WriteRaw("\r\n");

       // writing the main tag that encloses all node tags

       textWriter.WriteStartElement("TreeView");
       
       // save the nodes, recursive method

       SaveNodes(treeView.Nodes, textWriter);
       
       textWriter.WriteEndElement();
         
       textWriter.Close();
  }

The above code I guess is pretty much self explanatory. The SerializeTreeView method:

  1. Instantiates the XmlTextWriter, passing it the provided filename.
  2. XML declaration (<?xml version="1.0" encoding="us-ascii" ?>) is written to the stream.
  3. The TreeView tag is written to the stream.
  4. SaveNodes method is called. The TreeNode collection in a TreeView is passed to it, it saves all the nodes in a TreeView to the stream calling itself recursively. Its definition is produced below.
  5. The end tag of TreeView is written.
  6. And finally the stream is closed.

Following is the definition of SaveNodes method:

private void SaveNodes(TreeNodeCollection nodesCollection, 
   XmlTextWriter textWriter)
  {
       for(int i = 0; i < nodesCollection.Count; i++)
       {
            TreeNode node = nodesCollection[i];
            textWriter.WriteStartElement(XmlNodeTag);
            textWriter.WriteAttributeString(XmlNodeTextAtt, 
                                                       node.Text);
            textWriter.WriteAttributeString(
                XmlNodeImageIndexAtt, node.ImageIndex.ToString());
            if(node.Tag != null) 
                 textWriter.WriteAttributeString(XmlNodeTagAtt, 
                                             node.Tag.ToString());
            // add other node properties to serialize here  

            if (node.Nodes.Count > 0)
            {
                 SaveNodes(node.Nodes, textWriter);
            }     
            textWriter.WriteEndElement();
       }
  }

The SaveNodes method loops through the TreeNode collection, and writes the node tag and its attributes. If a node has child nodes then the method is called recursively. After the method returns, having written the child nodes to the stream, the node end tag is written.

XML File Viewer

There is another method in the TreeViewSerializer class called LoadXmlFileInTreeView. This can be used to view any XML document in the TreeView. The following screen shot displays our sample XML file loaded into the TreeView:

The code for loading an XML file is pretty much similar to the SerializeTreeView method. I am not including the code here for the sake of brevity. You can find it in the attached source code.

Demo application

A demo application is provided with the article as the driver of TreeViewSerializer functionality. It has three functions:

  • Save: save/serialize the TreeView to an XML file. A SaveFileDialog appears for specifying the file.
  • Load: load/deserialize the TreeView from an XML file.
  • View XML File: to view any XML file in the TreeView.

Notes

The XML document can also be manipulated using the DOM based XmlDocument and XmlNode classes. They are useful if we require searching and editing of XML document. In our case, XmlTextWriter and XmlTextReader are more efficient as they operate in a forward only, non-cached manner.

The generated XML file is not formatted by inserting a new line and tabs. Use textWriter.WriteRaw("\r\n"); at appropriate places in SerializeTreeView for this purpose. Obviously, you may use IE to view the formatted XML file. :)

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here