Click here to Skip to main content
15,867,704 members
Articles / Programming Languages / XML

XML Serialization in .NET

Rate me:
Please Sign up or sign in to vote.
4.33/5 (12 votes)
26 Jul 20023 min read 244.7K   697   54   32
This article shows an example of how to use XML serialization in .NET

Sample Image

Introduction

My previous article, Hash Table and Serialization in .NET, describes how the content of a hash table is serialized to and deserialized from a binary file. This article continues the serialization topic, and describes XML serialization in .NET, where objects are serialized and deserialized into and from XML documents.

XML serialization implemented by XMLSerializer class converts an object's public classes, properties and fields to a serial XML format. The following example shows how an object of the Person class is serialized into an XML document.

C#
class Person
{
   public Person( string firstName, string lastName )
   {
      this.firstName = firstName;
      this.lastName = lastName;
   }

   public string firstName;
   public string lastName;
}   

static void Main()
{
   Person person = new Person( "John", "Doe" );

   XmlSerializer x = new XmlSerializer( typeof(Person) );
   TextWriter writer = new StreamWriter( "person.xml" );
   x.Serialize( writer, person );
}

If you run the above example, you will get a runtime error message, System.InvalidOperationException. The error is caused by the line XmlSerializer x = new XmlSerializer( typeof(Person) );. As it turns out, the class Person requires a modifier public and a default constructor. These are common mistakes that I made while working with XmlSerializer class. After you add the public modifier and the default constructor to the Person class, you will get the following XML elements.

XML
<?xml version="1.0 encoding="utf-8"?>
<Person xmlns:xsd="http:www.w3.org/2001/XMLScheme"
        xmlns:xsi="http:www.w3.org/2001/XMLScheme-instance">
    <firstName>John</firstName>
    <lastName>Doe</lastName>
</Person>

As you can see, the element names in the above XML document reflect the public member variable names. You may ask what if I want to make the member variables private. Can I still serialize this class? XmlSerializer cannot serialize private members, however, you can use public properties as the access methods to the private members as shown below:

C#
public string FirstName
{
   get { return firstName; }
   set { firstName = value; }
}

public string LastName
{
   get { return lastName; }
   set { lastName = value; }
}

private string firstName;
private string lastName;

In this case, the XML elements would be FirstName and LastName instead of firstname and lastname respectively to reflect the property names. You can change the XML element names, so that they are different from the property names by using C# attributes. For example, if you want to change the FirstName element to MyFirstName, you can add the following XML element attribute to the FirstName property.

C#
[XmlElement(ElementName = "MyFirstName")]
public string FirstName
{
   get { return firstName; }
   set { firstName = value; }
}

Now, let's expand on the above concept to a more complex application such as a phone book application as described in my previous article, Hash Table and Serialization in .NET. The following UML class diagram shows the relationships between classes that are part of the application. The Contacts class contains one or more Contact, and Contact class contains a Person class and a PhoneNumber class.

UML Diagram

The Person, PhoneNumber, and Contact classes are straight forward and self explanatory, so I will not go into the details of these classes. The Contacts class has a private hash table member variable table that takes the Person object as the key and the Contact object as the value. Since this hash table member variable contains all of the contacts, it will be nice if it can be serialized directly to a XML document. However, as it turns out, XmlSerializer does not work with the Hashtable class because the Hashtable indexer takes a non-integer parameter (object parameter), and XmlSerializer expects indexers with only an integer parameter. So in order to serialize all of the contacts to the XML document, the hash table is converted to a Contact array, and this array is then serialized to an XML document as shown below:

C#
// Create an instance of Contact array, and copy the content of 
// the hash table to this array
Contact[] aContact = new Contact[table.Count];
table.Values.CopyTo( aContact, 0 );

// Deserialize the content of the Contact array to a XML file
XmlSerializer x = new XmlSerializer( typeof(Contact[]) );
TextWriter writer = new StreamWriter( "phonebook.xml" );
x.Serialize( writer, aContact );

To deserialize the XML elements from the XML document to the hash table, the above steps will be reversed. The XML elements are first deserialized to a Contact array, and then each member of the array is added to the hash table as follows:

C#
// Create an instance of the XmlSerializer class of type Contact array 
XmlSerializer x = new XmlSerializer( typeof(Contact[]) );

// Read the XML file if it exists ---
FileStream fs = null;
try
{
   fs = new FileStream( "phonebook.xml", FileMode.Open );

   // Deserialize the content of the XML file to a Contact array 
   // utilizing XMLReader
   XmlReader reader = new XmlTextReader(fs);         
   Contact[] contacts = (Contact[]) x.Deserialize( reader );

   // Add each member of the Contact array to the hash table
   for ( int i = 0; i < contacts.Length; i++ )
   {
      Contact contact = (Contact) contacts[i];
      table.Add( contact.GetPerson, contact );
   }
}
catch( FileNotFoundException )
{
   // Do nothing if the file does not exists
}
finally
{
   if ( fs != null ) fs.Close();
}

That is all for now. I hope you enjoy this brief introduction on XML serialization in .NET.

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.


Written By
Web Developer
United States United States
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
QuestionAre there mechanisms to tell when an object is being deserialized? Pin
Adrian Gouder17-Nov-19 20:03
Adrian Gouder17-Nov-19 20:03 
QuestionGood one Pin
exsquare25-Sep-13 3:26
professionalexsquare25-Sep-13 3:26 
QuestionHow to Serialize [CDATA] node using XMLSerializer Pin
ghorpade.sangram11-Dec-07 2:21
ghorpade.sangram11-Dec-07 2:21 
Questionserializing a System.Windows.Forms.Button Class Pin
ankur.ag198124-Jul-06 21:32
ankur.ag198124-Jul-06 21:32 
QuestionAny plans to upgrade to 2.0? Pin
wws3580111-Feb-06 19:15
wws3580111-Feb-06 19:15 
Generalcomments Pin
adras17-Jan-06 21:56
adras17-Jan-06 21:56 
GeneralXML Serialization in which a variable name can be assigned to ElementName Pin
Snehal Ganjigatti22-Jul-05 10:15
Snehal Ganjigatti22-Jul-05 10:15 
GeneralDouble array serialized Pin
Exnor1-Jun-05 3:05
Exnor1-Jun-05 3:05 
Generaldeserialization Pin
somiali9-Oct-03 7:15
somiali9-Oct-03 7:15 
GeneralSerializing XmlSchema Array Pin
manij28-Jul-03 4:49
manij28-Jul-03 4:49 
GeneralSerializing Objects within objects Pin
Justin Armstrong30-Jun-03 9:47
Justin Armstrong30-Jun-03 9:47 
GeneralRe: Serializing Objects within objects Pin
Heath Stewart30-Jun-03 11:15
protectorHeath Stewart30-Jun-03 11:15 
Use XmlElement and XmlAttribute anywhere you want. I recomment using XmlElement on non-intrinsic properties (where as you put XmlRoot on the class itself, but the prop attribute overrides). Basically, you do whatever you want. The XmlSerialier (or any serializer that's written correctly) will serialize an entire object graph, as serializers are supposed to.

Here's what I recommend:
[XmlRoot("bankAccount")]
public class BankAccount
{
[XmlAttribute("accountNumber")]
public int accountNumber;

[XmlAttribute("balance")]
public float balance;
}

[XmlRoot("person")]
public class Person
{
[XmlAttribute("id")]
public int id;

[XmlAttribute("name")]
public string name;

[XmlElement("account")]
public BankAccount account;
}



Reminiscent of my younger years...
10 LOAD "SCISSORS"
20 RUN

GeneralRe: Serializing Objects within objects Pin
Justin Armstrong2-Jul-03 13:25
Justin Armstrong2-Jul-03 13:25 
GeneralRe: Serializing Objects within objects Pin
Heath Stewart2-Jul-03 18:06
protectorHeath Stewart2-Jul-03 18:06 
GeneralRe: Serializing Objects within objects Pin
Justin Armstrong3-Jul-03 6:49
Justin Armstrong3-Jul-03 6:49 
GeneralRe: Serializing Objects within objects Pin
Heath Stewart3-Jul-03 8:47
protectorHeath Stewart3-Jul-03 8:47 
GeneralRe: Serializing Objects within objects Pin
Justin Armstrong3-Jul-03 10:39
Justin Armstrong3-Jul-03 10:39 
GeneralRe: Serializing Objects within objects Pin
Heath Stewart3-Jul-03 10:59
protectorHeath Stewart3-Jul-03 10:59 
GeneralRe: Serializing Objects within objects Pin
Justin Armstrong4-Jul-03 8:03
Justin Armstrong4-Jul-03 8:03 
GeneralRe: Serializing Objects within objects Pin
Heath Stewart7-Jul-03 2:15
protectorHeath Stewart7-Jul-03 2:15 
GeneralRe: Serializing Objects within objects Pin
Justin Armstrong8-Jul-03 6:40
Justin Armstrong8-Jul-03 6:40 
GeneralRTF string Pin
Lerede 22-Jun-03 21:09
Lerede 22-Jun-03 21:09 
GeneralSerializing ArrayList of ArrayLists Pin
Aaron R>18-Jun-03 6:55
Aaron R>18-Jun-03 6:55 
GeneralRe: Serializing ArrayList of ArrayLists Pin
Liong Ng28-Jun-03 11:25
Liong Ng28-Jun-03 11:25 
Generalhelp with serialization Pin
baby.chai26-Mar-03 8:46
baby.chai26-Mar-03 8:46 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.