Introduction to Using XML with VB.NET 2012

CodeGuru content and product recommendations are editorially independent. We may make money when you click on links to our partners. Learn More.

Introduction

Welcome to today’s article! Today I will demonstrate how to work with XML files with VB.NET. We will create an XML file, add nodes and elements onto it, and then remove the nodes and elements.

Introduction to XML

Here is a very nice and detailed explanation of the term ‘XML’, just in case you have never heard about it.

As always, it is best to learn practically, so let us start.

Design

Open up Visual Studio 2012 and create a new VB.NET Windows Forms application. You may name it anything you like. Design the form to resemble Figure 1.

Our design
Figure 1 – Our design

Please note that, although you may name your controls anything you like, I may have named mine differently.

Code

As always, let me start with the necessary Namespaces that we will need today. Add the following namespaces:

Imports System.Xml 'XML Capabilities
Imports System.Xml.Serialization 'XML Serialization Abilities
Imports System.Text 'StringBuilder

Now, let’s add a modular variable that will represent the XML documents we will create and manipulate:

	Private xdDoc As New XmlDocument() 'Create Modular XMLDocument Object

Creating an XML File

Behind the button labelled “Create Document” add the following code:

	Private Sub btnCreate_Click( sender As Object,  e As EventArgs) Handles btnCreate.Click

		'Store Hardcoded XML Values
		xdDoc.LoadXml("<Student><Name>Hannes</Name></Student>")

		'Save Document & Auto-Indent Output
        Dim xtwWriter As New XmlTextWriter("Example.xml", Nothing)

		xtwWriter.Formatting = Formatting.Indented
		xdDoc.Save(xtwWriter)

		xtwWriter.Close

	End Sub

This code starts with the LoadXml method of the XML document object. In there, I have created a very small XML structured statement. Ultimately, whatever I have entered in there will be the physical XML document’s contents. Obviously, there are far more complicated ways to create bigger XML documents, but seeing the fact that this article only serves as an introduction, I won’t get too complicated.

I then created an XMLTextWriter object. This object is responsible for writing the above contents to the given file in the given format. Then, I simply save the XML document and close it. really not too complicated now is it?

Reading XML File Contents

Add the following code behind the button labelled “Read Document“:

	Private Sub btnRead_Click( sender As Object,  e As EventArgs) Handles btnRead.Click

        'Read XML File
		Dim xtrReader As New XmlTextReader("Example.xml")

        Dim sbReadXML As New StringBuilder 'Create StringBuilder Object To Host Contents

        While xtrReader.Read() 'While The Reader Is Reading The Data

            Select Case xtrReader.NodeType 'What Type Of XML Data Are We Working With?

                Case Xml.XmlNodeType.Element 'Is It An Element?

                    sbReadXML.Append(xtrReader.Name) 'Get Element Name

                Case Xml.XmlNodeType.Text 'Is It Ordinary Text? Get Values

					'Add : And The Value Being Read
					sbReadXML.Append(": ")
					sbReadXML.Append(xtrReader.Value)

					'Add A New Line
					sbReadXML.AppendLine()

            End Select

        End While

		txtContent.Text = sbReadXML.ToString 'Show Contents

	End Sub

Here I created a new XMLTextReader object to read the file named Example.xml. I then created a StringBuilder object to gradually append the file’s content into one singular string. Inside the While loop I simply detect what type of XML content the reader is busy reading. If it is currently reading an XML Element object, it must store the current element’s name. If it is reading the contents of an XML element, in other words, the text value, it must append a colon and the value. This will produce a string such as:

Name : Hannes

Lastly, it outputs the StringBuilder’s content into the textbox named txtContent.

Reading XML Element Content

It may seem strange that I am explaining the same thing over, but there is a slight difference. Reading a singular Element is a tad different. How? Well, add the following code behind the button labelled “Read Element“:

	Private Sub btnReadElement_Click( sender As Object,  e As EventArgs) Handles btnReadElement.Click

	   xdDoc.Load("Example.xml") 'Load File

	   'Select Singular Node
	   Dim xnNode As XmlNode = xdDoc.SelectSingleNode("/Student/Teacher/Name")

	   'Display Node Value
       txtContent.Text = xnNode.InnerText

	End Sub

Here, I loaded the xml file called Example.xml into memory, created an XML node object, and then used  its SelectSingleNode method to read the specified XML path, which is the node to read. Lastly, I display the node’s InnerText property inside the Textbox.

Adding XML Elements to an Existing XML File

Add the following code behind the “Append Element” button:

	Private Sub btnAppend_Click( sender As Object,  e As EventArgs) Handles btnAppend.Click

		xdDoc.Load("Example.xml") 'Load XML File

		'Add Surname Element.
		Dim xeElement As XmlElement
		xeElement = xdDoc.CreateElement("Surname")

        xeElement.InnerText = "du Preez" 'Supply Value
        xdDoc.DocumentElement.AppendChild(xeElement)

		'Save
        Dim xtwWriter As New XmlTextWriter("Example.xml", Nothing)

		xtwWriter.Formatting = Formatting.Indented
		xdDoc.Save(xtwWriter)

		xtwWriter.Close()

	End Sub

Here, I load the document into memory; then, I make use of the CreateElement method of the document object to name the new element to be added. I specify its value via the InnerText property and use the AppendChild method of DocumentElement to physically add it onto the file. The saving of the document is the same code I used in the very first exercise we did (creating an XML file).

Adding Nodes

Add the following code:

	Private Sub btnAppendNode_Click( sender As Object,  e As EventArgs) Handles btnAppendNode.Click

		xdDoc.Load("Example.xml")

		Dim xnRoot As XmlNode = xdDoc.DocumentElement 'Determine Root Of XML Document ( Student )

		'Create Two New Elements
		Dim xeMainElement As XmlElement = xdDoc.CreateElement("Teacher")
		Dim xeSubElement As XmlElement = xdDoc.CreateElement("Name")

		xeSubElement.InnerText = "Elmarie" 'Name Element Value Is "Elmarie"

		xnRoot.AppendChild(xeMainElement) 'Add Teacher To Root

		xeMainElement.AppendChild(xeSubElement) 'Add Name To Teacher Element

		'Save
		Dim xtwWriter As New XmlTextWriter("Example.xml", Nothing)

		xtwWriter.Formatting = Formatting.Indented
		xdDoc.Save(xtwWriter)

		xtwWriter.Close()

	End Sub

This code determines the current root element. I then create two elements under each other and specify each element’s values. I append the Main Element onto the root, and then append the sub element onto it. It is actually quite simple – you just need to know your supplied XML document’s structure.

Conclusion

As you can see, working with XML and VB is not so scary as many people think. If you have this basic knowledge, you will be able to manipulate any XML file, whether it be with my basic demonstration or with more advanced techniques you acquire eventually.

I hope you have enjoyed this short but powerful demonstration. Until next time, this is me signing off!

Hannes DuPreez
Hannes DuPreez
Ockert J. du Preez is a passionate coder and always willing to learn. He has written hundreds of developer articles over the years detailing his programming quests and adventures. He has written the following books: Visual Studio 2019 In-Depth (BpB Publications) JavaScript for Gurus (BpB Publications) He was the Technical Editor for Professional C++, 5th Edition (Wiley) He was a Microsoft Most Valuable Professional for .NET (2008–2017).

More by Author

Get the Free Newsletter!

Subscribe to Developer Insider for top news, trends & analysis

Must Read