Home

Operations on XML Elements

 

Introduction

So far, to create an XML element, we were directly typing in a file. When such a file had been created and saved, it was ready to be processed. Here is an example of a file named videos.xml:

<?xml version="1.0" encoding="utf-8" ?>
<videos>
  <title>The Distinguished Gentleman</title>
</videos>

In some applications, you will want the user to provide you with the necessary value(s) to create an element. Fortunately, the XmlDocument, the XmlNode, and the XmlElement classes provide all the necessary properties and methods to perform the routine operations of an XML file, an element, or a node. The operations include locating a node, adding a new element, or deleting a node.

Before performing an operation, you will usually need to decide in what section of the file you want to action to bee applied. As it happens, you have the root node, a particular node inside the file, parent of a node, the sibling of a node, etc. To get to a node, you will usually first get a reference to its XmlElement. To do this, you can declare an XmlElement variable and initialize it with that reference.

Appending an Element

To assist with programmatically creating a new element, the XmlDocument class provides the CreateElement() method that is overloaded with three versions. One of the versions uses the following syntax:

public XmlElement CreateElement(string name);

Using this method, to create a new element, call it and pass it the name of the element. For example, imagine you want to add a new Title element to the above file. You would start with code as follows:

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;
using System.IO;
using System.Xml;

namespace videoCollection1
{
    public partial class Exercise : Form
    {
        public Exercise()
        {
            InitializeComponent();
        }

        private void btnDocument_Click(object sender, EventArgs e)
        {
            string strFilename = "videos.xml";
            XmlDocument xmlDoc = new XmlDocument();

            if (File.Exists(strFilename))
            {
                xmlDoc.Load(strFilename);

                XmlElement elmNew = xmlDoc.CreateElement("Title");
            }

        }
    }
}

In order to add the new element to the file, you must specify its position in the tree: whether it would be the first or the last node, whether you want to position it before or after a node of your choice. For example, if you want to add a new Title element to the above file, it would be considered a child of the root, that is, a child of the XmlDocument.DocumentElement property. In the previous lesson, we learned how to get a reference to the root node.

To support the positions of existing nodes, the XmlNode class, which is the ancestor of all XML nodes of the .NET Framework, provides various appropriate methods. One of these methods is AppendChild(), which is used to add an element as the last child of its parent. The syntax of the XmlNode.AppendChild() method is:

public virtual XmlNode AppendChild(XmlNode newChild);

When calling this method, pass the XmlNode object you had previous created. After adding the node, if you want the file to keep it, you should save it. Here is an example:

private void btnDocument_Click(object sender, EventArgs e)
{
    string strFilename = "videos.xml";
    XmlDocument xmlDoc = new XmlDocument();

    if (File.Exists(strFilename))
    {
        xmlDoc.Load(strFilename);

        XmlElement elmRoot = xmlDoc.DocumentElement;
        XmlElement elmNew = xmlDoc.CreateElement("title");
        elmRoot.AppendChild(elmNew);

        xmlDoc.Save(strFilename);
    }
}

This would produce:

<?xml version="1.0" encoding="utf-8"?>
<videos>
  <title>The Distinguished Gentleman</title>
  <title />
</videos>

Notice that the newly added element is empty.

Adding the Inner Text of an Element

Suppose you have the following videos.xml file:

<?xml version="1.0" encoding="utf-8"?>
<videos>
  <video>
    <title>The Distinguished Gentleman</title>
    <director>Jonathan Lynn</director>
    <length>112 Minutes</length>
    <format>DVD</format>
    <rating>R</rating>
  </video>
  <video>
    <title>Her Alibi</title>
    <director>Bruce Beresford</director>
    <length>94 Minutes</length>
    <format>DVD</format>
    <rating>PG-13</rating>
  </video>
</videos>

Imagine that you want to add a video element. You have a choice of adding one, more, or all child elements of the video node. To perform this operation, one solution you can use is to "build" all child elements of the video element, then add the node as a whole.

In the previous lesson, we saw that the XmlNode.InnerXml property comprises a node, its markup, its children and their markup. This means that you can create the child nodes with their markup(s) as a string and assign that string to an XmlNode.InnerXml string. To do this, you would need the set version of the InnerXml property. It is declared as follows:

public virtual string InnerXml{get; set;}

Here is an example that adds a complete new video node to the above XML file:

private void btnDocument_Click(object sender, EventArgs e)
{
    string strFilename = "videos.xml";
    XmlDocument xmlDoc = new XmlDocument();

    if (File.Exists(strFilename))
    {
        xmlDoc.Load(strFilename);

        XmlElement elmXML = xmlDoc.CreateElement("video");
        string strNewvideo = "<title>Other People's Money</title>" +
                             "<director>Alan Brunstein</director>" +
                             "<length>114 Minutes</length>" +
                             "<format>VHS</format>" +
                             "<rating>PG-13</rating>";

        elmXML.InnerXml = strNewvideo;
        xmlDoc.DocumentElement.AppendChild(elmXML);

        xmlDoc.Save(strFilename);
    }
}

This would produce:

<?xml version="1.0" encoding="utf-8"?>
<videos>
  <video>
    <title>The Distinguished Gentleman</title>
    <director>Jonathan Lynn</director>
    <length>112 Minutes</length>
    <format>DVD</format>
    <rating>R</rating>
  </video>
  <video>
    <title>Her Alibi</title>
    <director>Bruce Beresford</director>
    <length>94 Mins</length>
    <format>DVD</format>
    <rating>PG-13</rating>
  </video>
  <video>
    <title>Other People's Money</title>
    <director>Alan Brunstein</director>
    <length>114 Minutes</length>
    <format>VHS</format>
    <rating>PG-13</rating>
  </video>
</videos>

Adding an Element With Value

Consider the following XML file named videos.xml:

<?xml version="1.0" encoding="utf-8" ?>
<videos>
  <title>The Distinguished Gentleman</title>
</videos>

If you want the element to have a value, the XmlDocument class provides the CreateTextNode() method. This method returns an XmlText value. The syntax of this method is:

public virtual XmlText CreateTextNode(string text);

This method takes as argument the string that would constitute the value of the element. Before calling it, you should have used the XmlNode.AppendChild() method to create a node. Calling this method on the LastChild node of the one that called the AppendChild() would specify the value of the new node. Here is an example:

private void btnDocument_Click(object sender, EventArgs e)
{
    string strFilename = "videos.xml";
    XmlDocument xmlDoc = new XmlDocument();

    if (File.Exists(strFilename))
    {
        xmlDoc.Load(strFilename);

        XmlElement elmRoot = xmlDoc.DocumentElement;

        XmlElement elmNew = xmlDoc.CreateElement("title");
        XmlText txtvideo = xmlDoc.CreateTextNode("Basic Instinct");
        elmRoot.AppendChild(elmNew);
        elmRoot.LastChild.AppendChild(txtvideo);

        xmlDoc.Save(strFilename);
    }
}

This would produce:

<?xml version="1.0" encoding="utf-8"?>
<videos>
  <title>The Distinguished Gentleman</title>
  <title>Basic Instinct</title>
</videos>

The combination of calls to XmlDocument.CreateElement() and XmlDocument.CreateTextNode() allow you to create a new element that has a value.

Consider the following XML file named "videos.xml":

<?xml version="1.0" encoding="utf-8"?>
<videos>
  <video>
    <title>The Distinguished Gentleman</title>
  </video>
  <video>
    <title>Basic Instinct</title>
  </video>
</videos>

Notice that the root, videos, has a repetitive child named video. This video child has its own child named Title. Imagine that you want to add a new video node that has a child. To do this, first create an empty video node as a child of the root. We learned earlier how to do that:

private void btnDocument_Click(object sender, EventArgs e)
{
    string strFilename = "videos.xml";
    XmlDocument xmlDoc = new XmlDocument();

    if (File.Exists(strFilename))
    {
        xmlDoc.Load(strFilename);

        XmlElement elmRoot = xmlDoc.DocumentElement;
        XmlElement elmNew = xmlDoc.CreateElement("video");
        elmRoot.AppendChild(elmNew);
    }
}

After creating the new child of the root, initialize the grand child with the desired name (the name doesn't have to be one of the existing names) and a value (which is optional if you don't want the new node to have a value). Once the new node is ready, append it as the last child of the root. If this new node has a value, append its XmlText object as the LastChild of the LastChild of the root. Here is an example of how you would do this:

private void btnDocument_Click(object sender, EventArgs e)
{
    string strFilename = "videos.xml";
    XmlDocument xmlDoc = new XmlDocument();

    if (File.Exists(strFilename))
    {
        xmlDoc.Load(strFilename);

        XmlElement elmRoot = xmlDoc.DocumentElement;
        XmlElement elmNew = xmlDoc.CreateElement("video");
        elmRoot.AppendChild(elmNew);

        elmRoot = xmlDoc.DocumentElement;

        elmNew = xmlDoc.CreateElement("title");
        XmlText txtvideo = xmlDoc.CreateTextNode("Her Alibi");

        elmRoot.LastChild.AppendChild(elmNew);
        elmRoot.LastChild.LastChild.AppendChild(txtvideo);

        xmlDoc.Save(strFilename);
    }
}

This would produce:

<?xml version="1.0" encoding="utf-8"?>
<videos>
  <video>
    <title>The Distinguished Gentleman</title>
  </video>
  <video>
    <title>Basic Instinct</title>
  </video>
  <video>
    <title>Her Alibi</title>
  </video>
</videos>

Now consider the following file:

<?xml version="1.0" encoding="utf-8"?>
<videos>
  <video>
    <title>The Distinguished Gentleman</title>
    <director>Jonathan Lynn</director>
    <length>112 Minutes</length>
    <format>DVD</format>
    <rating>R</rating>
  </video>
  <video>
    <title>Her Alibi</title>
    <director>Bruce Beresford</director>
    <length>94 Minutes</length>
    <format>DVD</format>
    <rating>PG-13</rating>
  </video>
</videos>

The root, videos, has a child named video. The video node has many child nodes. By now, we know how to add a child to the root. We also saw how to add a grand child with value to the root. To had many (grand) children to a node, first build the node, add it to the root, then continuously add the necessary nodes, one at a time, including its name and its optional value. This would be done as follows:

private void btnDocument_Click(object sender, EventArgs e)
{
    string strFilename = "videos.xml";
    XmlDocument xmlDoc = new XmlDocument();

    if (File.Exists(strFilename))
    {
        xmlDoc.Load(strFilename);

        XmlElement elmRoot = xmlDoc.DocumentElement;
        XmlElement elmNew = xmlDoc.CreateElement("video");
        elmRoot.AppendChild(elmNew);

        elmRoot = xmlDoc.DocumentElement;

        elmNew = xmlDoc.CreateElement("title");
        XmlText txtvideo = xmlDoc.CreateTextNode("The Day After Tomorrow");
        elmRoot.LastChild.AppendChild(elmNew);
        elmRoot.LastChild.LastChild.AppendChild(txtvideo);

        elmNew = xmlDoc.CreateElement("director");
        txtvideo = xmlDoc.CreateTextNode("Roland Emmerich");
        elmRoot.LastChild.AppendChild(elmNew);
        elmRoot.LastChild.LastChild.AppendChild(txtvideo);

        elmNew = xmlDoc.CreateElement("length");
        txtvideo = xmlDoc.CreateTextNode("124 Minutes");
        elmRoot.LastChild.AppendChild(elmNew);
        elmRoot.LastChild.LastChild.AppendChild(txtvideo);

        elmNew = xmlDoc.CreateElement("format");
        txtvideo = xmlDoc.CreateTextNode("DVD");
        elmRoot.LastChild.AppendChild(elmNew);
        elmRoot.LastChild.LastChild.AppendChild(txtvideo);

        elmNew = xmlDoc.CreateElement("rating");
        txtvideo = xmlDoc.CreateTextNode("PG-13");
        elmRoot.LastChild.AppendChild(elmNew);
        elmRoot.LastChild.LastChild.AppendChild(txtvideo);

        xmlDoc.Save(strFilename);
    }
}

 This would produce:

<?xml version="1.0" encoding="utf-8"?>
<videos>
  <video>
    <title>The Distinguished Gentleman</title>
    <director>Jonathan Lynn</director>
    <length>112 Minutes</length>
    <format>DVD</format>
    <rating>R</rating>
  </video>
  <video>
    <title>Her Alibi</title>
    <director>Bruce Beresford</director>
    <length>94 Minutes</length>
    <format>DVD</format>
    <rating>PG-13</rating>
  </video>
  <video>
    <title>The Day After Tomorrow</title>
    <director>Roland Emmerich</director>
    <length>124 Minutes</length>
    <format>DVD</format>
    <rating>PG-13</rating>
  </video>
</videos>

Using the same approach, you can add children to children of children, and so on.

 

Previous Copyright © 2007 FunctionX, Inc. Next