ARTICLE

Serializing Objects in C#

Posted by Bipin Joshi Articles | C# Language May 14, 2001
In simple words serialization is a process of storing the object instance to a disk file. Serialization stores state of the object i.e. member variable values to disk. Deserialization is reverse of serialization.
Reader Level:

Introduction

In simple words serialization is a process of storing the object instance to a disk file. Serialization stores state of the object i.e. member variable values to disk. Deserialization is reverse of serialization i.e. it's a process of reading objects from a file where they have been stored. In this code sample we will see how to serialize and deserialize objects using C#.

Namespaces involved

Following namespaces are involved in serialization process :

  • System.Runtime.Serialization
  • System.Runtime.Serialization.Formatters.Binary

Example 1

using System;
using System.IO;
using System.Runtime.Serialization;
using System.Runtime.Serialization.Formatters.Binary;
public class SerialTest
{
public void SerializeNow()
{
ClassToSerialize c=
new ClassToSerialize();
File f=
new File("temp.dat");
Stream s=f.Open(FileMode.Create);
BinaryFormatter b=
new BinaryFormatter();
b.Serialize(s,c);
s.Close();
}
public void DeSerializeNow()
{
ClassToSerialize c=
new ClassToSerialize();
File f=
new File("temp.dat");
Stream s=f.Open(FileMode.Open);
BinaryFormatter b=
new BinaryFormatter();
c=(ClassToSerialize)b.Deserialize(s);
Console.WriteLine(c.name);
s.Close();
}
public static void Main(string[] s)
{
SerialTest st=
new SerialTest();
st.SerializeNow();
st.DeSerializeNow();
}
}
public class ClassToSerialize
{
public int age=100;
public string name="bipin";
}
 
Explanation

Here we have our own class named ClassToSerialize. This class has two public valiables name and age with some default values. We will write this class to a disk file (temp.dat) using SerializeTest class.

SerializeTest class has two methods SerializeNow() and DeSerializeNow() which perform the task of serialization and deserialization respectively.

The general steps for serializing are :

  • Create an instance of File that will store serialized object.
  • Create a stream from the file object.
  • Create an instance of BinaryFormatter.
  • Call serialize method of the instance passing it stream and object to serialize.

The steps for de-serializing the object are similar. The only change is that you need to call deserialize method of BinaryFormatter object.

Now, let us see an example where we have used 'real' class with public and shared members and properties to encapsulate them. The class also uses another supporting class. This is just to make clear that if your class contains further classes, all the classes in the chain will be serialized.

Example 2

using System;
using System.IO;
using System.Runtime.Serialization;
using System.Runtime.Serialization.Formatters.Binary;
public class SerialTest
{
public void SerializeNow()
{
ClassToSerialize c=
new ClassToSerialize();
c.Name="bipin";
c.Age=26;
ClassToSerialize.CompanyName="xyz";
File f=
new File("temp.dat");
Stream s=f.Open(FileMode.Create);
BinaryFormatter b=
new BinaryFormatter();
b.Serialize(s,c);
s.Close();
}
public void DeSerializeNow()
{
ClassToSerialize c=
new ClassToSerialize();
File f=
new File("temp.dat");
Stream s=f.Open(FileMode.Open);
BinaryFormatter b=
new BinaryFormatter();
c=(ClassToSerialize)b.Deserialize(s);
Console.WriteLine("Name :" + c.Name);
Console.WriteLine("Age :" + c.Age);
Console.WriteLine("Company Name :" + ClassToSerialize.CompanyName);
Console.WriteLine("Company Name :" + c.GetSupportClassString());
s.Close();
}
public static void Main(string[] s)
{
SerialTest st=
new SerialTest();
st.SerializeNow();
st.DeSerializeNow();
}
}
public class ClassToSerialize
{
private int age;
private string name;
static string companyname;
SupportClass supp=
new SupportClass();
public ClassToSerialize()
{
supp.SupportClassString="In support class";
}
public int Age
{
get
{
return age;
}
set
{
age=
value;
}
}
public string Name
{
get
{
return name;
}
set
{
name=
value;
}
}
public static string CompanyName
{
get
{
return companyname;
}
set
{
companyname=
value;
}
}
public string GetSupportClassString()
{
return supp.SupportClassString;
}
}
public class SupportClass
{
public string SupportClassString;
}

Example 3

The final example shows how to serialize array of objects.

using System;
using System.IO;
using System.Runtime.Serialization;
using System.Runtime.Serialization.Formatters.Binary;
public class SerialTest
{
public void SerializeNow()
{
ClassToSerialize[] c=
new ClassToSerialize[3];
c[0]=
new ClassToSerialize();
c[0].Name="bipin";
c[0].Age=26;
c[1]=
new ClassToSerialize();
c[1].Name="abc";
c[1].Age=75;
c[2]=
new ClassToSerialize();
c[2].Name="pqr";
c[2].Age=50;
ClassToSerialize.CompanyName="xyz";
File f=new File("temp.dat");
Stream s=f.Open(FileMode.Create);
BinaryFormatter b=
new BinaryFormatter();
b.Serialize(s,c);
s.Close();
}
public void DeSerializeNow()
{
ClassToSerialize[] c;
File f=
new File("temp.dat");
Stream s=f.Open(FileMode.Open);
BinaryFormatter b=
new BinaryFormatter();
c=(ClassToSerialize[])b.Deserialize(s);
Console.WriteLine("Name :" + c[2].Name);
Console.WriteLine("Age :" + c[2].Age);
Console.WriteLine("Company Name :" + ClassToSerialize.CompanyName);
s.Close();
}
public static void Main(string[] s)
{
SerialTest st=
new SerialTest();
st.SerializeNow();
st.DeSerializeNow();
}
}
public class ClassToSerialize
{
private int age;
private string name;
static string companyname;
public int Age
{
get
{
return age;
}
set
{
age=
value;
}
}
public string Name
{
get
{
return name;
}
set
{
name=
value;
}
}
public static string CompanyName
{
get
{
return companyname;
}
set
{
companyname=
value;
}
}
}

Login to add your contents and source code to this article
post comment
     

Below is link that may of interest to you http://msdotnetbuddy.blogspot.in/2010/01/object-serialization-in-c.html

Posted by sangram desai Mar 10, 2012

ClassToSerialize needs to have a [Serializable] attribute. Otherwise we get error: Type 'SerializeTesting.ClassToSerialize' in Assembly 'SerializeTesting, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null' is not marked as serializable.

Posted by Roman Levitskiy Aug 02, 2011

It's very helpful,,but preety that it's no use for me!

Posted by tracy Dec 03, 2008

Why don't you also explain the intent and why you would need to serialize in context to a real-world example and REASON. Give me a situation where you need to serialize. Just showing how doesn't tell the intent or reason in a real situation. That is what really gets people to understand...situations in which you'd need to do this.

Posted by expresso na Oct 01, 2008

codes has some common errors Like in the file creation part that portion shd be like this-- FileInfo f = new FileInfo (@"C:\temp.dat"); FileStream s = f.Open(FileMode.OpenOrCreate,FileAccess.ReadWrite,FileShare.None); ClassToSerialize class and SupportClass shd be tagged as [Serializable] here is the complete code which will work--- using System; using System.Collections.Generic; using System.Text; using System.IO; using System.Runtime.Serialization; using System.Runtime.Serialization.Formatters.Binary; class SerialTest { public void SerializeNow() { ClassToSerialize c = new ClassToSerialize (); c.Name = "bipin"; c.Age = 26; ClassToSerialize.CompanyName = "xyz"; FileInfo f = new FileInfo (@"C:\temp.dat"); FileStream s = f.Open (FileMode.OpenOrCreate,FileAccess.ReadWrite,FileShare.None); BinaryFormatter b = new BinaryFormatter (); b.Serialize (s, c); s.Close (); } public void DeSerializeNow() { ClassToSerialize c = new ClassToSerialize (); FileInfo f = new FileInfo (@"C:\temp.dat"); FileStream s = f.Open (FileMode.Open); BinaryFormatter b = new BinaryFormatter (); c = (ClassToSerialize)b.Deserialize (s); Console.WriteLine ("Name :" + c.Name); Console.WriteLine ("Age :" + c.Age); Console.WriteLine ("Company Name :" + ClassToSerialize.CompanyName); Console.WriteLine ("Company Name :" + c.GetSupportClassString ()); s.Close (); } static void Main(string[] args) { SerialTest st = new SerialTest (); st.SerializeNow (); st.DeSerializeNow (); } } [Serializable] public class ClassToSerialize { private int age; private string name; static string companyname; SupportClass supp = new SupportClass (); public ClassToSerialize() { supp.SupportClassString = "In support class"; } public int Age { get { return age; } set { age = value; } } public string Name { get { return name; } set { name = value; } } public static string CompanyName { get { return companyname; } set { companyname = value; } } public string GetSupportClassString() { return supp.SupportClassString; } } [Serializable] public class SupportClass { public string SupportClassString; }

Posted by Amartya Mar 18, 2008
COMMENT USING
PREMIUM SPONSORS
DynamicPDF™ product line allows you to dynamically generate PDF documents, merge PDF documents and add new content to existing PDF documents from within your applications.
SPONSORED BY
  • PDF reports have never been easier to create. With our included WYSIWYG Designer, you can layout your reports, set up your data source and let DynamicPDF ReportWriter do the rest.
Get Career Advice from Experts