Click here to Skip to main content
15,860,943 members
Articles / Programming Languages / C#

DataStorage: Store settings type-safe

Rate me:
Please Sign up or sign in to vote.
4.50/5 (3 votes)
8 Aug 2012GPL33 min read 26K   234   9   5
Shows how to use the DataStorage classes to generate type-safe settings classes.

Introduction

This article describes the DataStorage classes. They provide type-safe hierarchic settings that can be stored in various formats. Currently, Registry, INI files, and XML are supported.

Using these classes, you will be able to generate settings classes that do the boring work for you. Usually, storing settings involves a lot of repetitive work, calling the same function to read a value, checking the type, casting it, and maybe doing something if the value is missing. The same goes for writing settings and you have to keep the reading and writing parts in sync when things change.

The DataStorage classes allow you to write the settings definitions in XML or build them with the Windows Forms application and then generates all the required classes for you. You can also create a hierarchy of classes, like in this sample:

331288/main_window.png

Background

The idea to the DataStorage came when we were thinking about completely rebuilding PDFCreator from scratch. It was still written in Visual Basic 6 and came to its limits on various points. When designing the new application, it became clear that manually rebuilding all the settings would be a painful job and would not be what we intended to do, so we looked for a better way.

One of the results is the DataStorage. On top of that, we have also built the DynamicTranslator, which will be described in another article later on.

Using the code

The idea was to have a unified way to access settings. The foundation of the DataStorage is a class that simply stores names and values of which all are strings. The names can be hierarchic by adopting the Windows folder syntax.

C#
data.setValue(@"Test\abc", @"my value");

This can be stored by passing it to a writer object:

C#
XmlFiles xml = new XmlFiles();
xml.setData(data);
xml.writeData(@"C:\test.xml");

This is the basic way of storing settings, but nothing is type-safe so far, as we are just using strings.

The DataStorageGenerator shown on the screenshot above does the actual magic. It creates the class hierarchy and all the code required to load and store the data properly.

After generating the above sample, you will receive a class called MySettings and another one called ProjectSettings. You can then store your:

C#
XmlFiles xml = new XmlFiles();
MySettings settings = new MySettings();
settings.saveData(xml, @"C:\test.xml");

The generated class will do all the work for you:

C#
public bool saveData(DataWriter dataWriter, string path) {
    try {
        data.clear();
        storeValues(data);
        dataWriter.setData(data);
        dataWriter.writeData(path);
        return true;
    } catch { return false; }
    
}

public void storeValues(Data data) {
    data.setValue(@"MySettings\LastFolder", LastFolder);
    data.setValue(@"MySettings\IntTest", IntTest.ToString());
    data.setValue(@"MySettings\IsTrue", IsTrue.ToString());
}

The same goes for loading values:

C#
public void readValues(Data data) {
    LastFolder = data.getValue(@"MySettings\LastFolder");
    try { IntTest = int.Parse(data.getValue(@"MySettings\IntTest")); }
      catch { IntTest = 0;}
    try { IsTrue = bool.Parse(data.getValue(@"MySettings\IsTrue")); }
      catch { IsTrue = true;}
}

You can see that this tries to parse the data correctly. If the data should be invalid or missing, the default value will be applied.

That's it so far, but there is one more thing to discover: Custom code sections. No real-world classes are generated and never modified. The custom code sections allow you to add things manually that will not be destroyed when regenerating the classes. This can be includes, custom functions, and so on. The custom sections look like this:

C#
// Custom Code starts here
// START_CUSTOM_SECTION:INCLUDES

  // my custom stuff

// END_CUSTOM_SECTION:INCLUDES
// Custom Code ends here. Do not edit below

Each section has a name (INCLUDES in this case) and will be put in the right spot again. So you can enhance the generated classes without breaking your custom parts. Of course, if you edit code outside the custom code sections, it will be lost.

A last note

I hope you have enjoyed this article. As this is my first one here, I am curious about what you think of the code, the idea behind it, and so on. If I'll find the time, I will also add an article about the DynamicTranslator. It is used for internationalization (i18n) of Windows Forms applications and uses the DataStorage to achieve that. By providing structured translation files, the translation will be applied to the Form by using translation and Reflection, making the work of translating large applications much easier.

There of course are still things to do in this project and it will grow as we make progress with PDFCreator. Most likely we will also set up a SourceForge project or something similar to keep track of everything.

History

  • 2012-02-16: Initial version.

License

This article, along with any associated source code and files, is licensed under The GNU General Public License (GPLv3)


Written By
pdfforge GbR
Germany Germany
Philip is a Software Architect with severaly years of experience. He studied business IT in the University of Wedel, Germany, and has reached his Masters degree in 2010. Back in 2002, he started his so far best-known software PDFCreator. The second developer joined two years later and since then, both constantly improve this piece of open source software.

Comments and Discussions

 
QuestionDo you still use DataStorage with PDFCreator? Pin
enter faker26-Jun-18 11:43
enter faker26-Jun-18 11:43 
QuestionTypical VB6 Developer Pin
FZelle22-Feb-12 0:29
FZelle22-Feb-12 0:29 
AnswerRe: Typical VB6 Developer Pin
pchinery22-Feb-12 1:17
pchinery22-Feb-12 1:17 
QuestionWhy not use serialization? Pin
gencha20-Feb-12 23:58
gencha20-Feb-12 23:58 
AnswerRe: Why not use serialization? Pin
pchinery21-Feb-12 0:14
pchinery21-Feb-12 0:14 

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.