Windows Phone 7 XML IsolatedStorage Example

项目
08/31/2010

For one of the apps I have been working on, I needed to persist a List<T> of T objects across sessions. They are simple objects with simple properties, so I decided to use XML. However, since WP7 is a new platform, there’s not a lot of information out there on what is a good best practice.

It turns out for simple situations like mine, serializing objects into XML and writing that to file is by far the easiest way to do it.

Let’s examine a scenario.

The App

This is not an app I am working on, but it is basically the same thing.

Let’s say that you want to track your jogs. Starting simple, you decide to track the following properties:

RouteID : int
Duration : TimeSpan (we will encounter an interesting serialization bug with TimeSpan as well)
Date : DateTime
Distance (miles) : float

Of course, we won’t attempt to build all of this here, but rather, focus on the storage aspect of it.

The “Jog” Object

You will persist a list of these objects to be able to view them historically. This is what a Jog object might look like. Note the extra property, DurationXml, with its special attributes – this exists because XmlSerializer does not properly serialize TimeSpan objects.

     public class Jog

        private TimeSpan _duration = new TimeSpan();

        public DateTime Date { get; set; }

        [XmlIgnore]

        public TimeSpan Duration

            get { return _duration; }

            set { _duration = value; }

        // HACK: This property only exists for XML serialization.

        // It gets serialized as a <Duration> tag.

        [XmlElement("Duration", DataType="duration")]

        public string DurationXml

get

                return XmlConvert.ToString(_duration);

set

                if (value == null)

                    _duration = TimeSpan.Zero;

                    return;

                TimeSpan newDuration = XmlConvert.ToTimeSpan(value);

                if (_duration == newDuration)

                    return;

                _duration = newDuration;

        public int RouteID { get; set; }

        public float Distance { get; set; }

Note the hackery around the Duration and DurationXml properties.

Jog List

For the purposes of this app, you’d have a List of Jog objects: List<Jog> which you keep as a static on the App class and maintain it there. You’d then create some methods in the App class that would help out with storage, and then call them from Application_Closing, Application_Launching, and Activated/Deactivated as you handle tombstoning and deactivation.

Storage Helper

Then, you might write a class like this which helps with storage, and keep it statically on the App class. All you have to do is call XmlSerializer.Serialize(object) and XmlHelper.Deserialize(xml) to manage the saving/loading of your object list. Put together, it looks like this:

     public class StorageHelper

        private const string FILE_NAME = "Jogs.xml";

        public List<Jog> LoadJogs()

            List<Jog> jogs = new List<Jog>();

            TextReader reader = null;

try

                IsolatedStorageFile isoStorage = IsolatedStorageFile.GetUserStoreForApplication();

                IsolatedStorageFileStream file = isoStorage.OpenFile(FILE_NAME, FileMode.OpenOrCreate);

                reader = new StreamReader(file);

                XmlSerializer xs = new XmlSerializer(typeof(List<Jog>));

                jogs.AddRange((List<Jog>)xs.Deserialize(reader));

                reader.Close();

            catch

            finally

                if (reader != null)

                    reader.Dispose();

            return jogs;

        public void SaveJogs(List<Jog> jogs)

            TextWriter writer = null;

try

                IsolatedStorageFile isoStorage = IsolatedStorageFile.GetUserStoreForApplication();

                IsolatedStorageFileStream file = isoStorage.OpenFile(FILE_NAME, FileMode.Create);

                writer = new StreamWriter(file);

                XmlSerializer xs = new XmlSerializer(typeof(List<Jog>));

                xs.Serialize(writer, jogs);

                writer.Close();

            catch

            finally

                if (writer != null)

                    writer.Dispose();

        public StorageHelper()

Don’t Forget Your References

One thing to note here is that several of the Xml classes won’t magically work with IntelliSense. You need to add references to System.Xml and System.Xml.Serialization for all this good stuff to work.

I’ll be posting an example Jog Tracker application that uses isolated storage in the coming weeks, but for now, this should be enough to get you started.

Comments

Anonymous
August 31, 2010
Excellent posting! I am writing a series on using UML in Visual Studio 2010 Ultimate at: http://bit.ly/alMGtu
Anonymous
August 31, 2010
Excellent posting! I am writing a series on using UML in Visual Studio 2010 Ultimate at: http://bit.ly/alMGtu
Anonymous
November 06, 2010
Nice post. I'd only suggest to use using statements for IsolatedStorageFile and IsolatedStorageFileStream as they implement IDisposable.
Anonymous
December 29, 2010
This seems to directly contridict the MSDN documentation for win7 phone. msdn.microsoft.com/.../system.xml.serialization.xmlserializer(v=VS.95).aspx It states you can't use xmlserializer on an ArrayList or List<T>.
Anonymous
December 29, 2010
This seems to directly contridict the MSDN documentation for win7 phone. msdn.microsoft.com/.../system.xml.serialization.xmlserializer(v=VS.95).aspx It states you can't use xmlserializer on an ArrayList or List<T>.
Anonymous
December 29, 2010
Hey Jason, The documentation states that it can't serialize arrays of ArrayList or arrays of List<T>. This means you can't serialize arrays where every element is another array. This example only deals with one-dimensional arrays.
Anonymous
February 22, 2011
You mentioned you would be posting an example Jog Tracker application, I was just wondering if you ever got round to it?
Anonymous
March 02, 2011
orale k padre x sierto saves como guardar y leer informacion de un txt en windows phone game 4.0????
Anonymous
March 02, 2011
@alf: Puede guardar cualquier tipo de datos en almacenamiento aislado. No debe estar en formato XML. Sin embargo, esto es la forma más fácil de hacerlo. Mis disculpas por gramática incorrecta; Esto viene de una herramienta de traductor.

通过