56

What is the recommended location to save user preference files? Is there a recommended method for dealing with user preferences?

Currently I use the path returned from typeof(MyLibrary).Assembly.Location as a default location to store files generated or required by the application.

EDIT: I found two related/interesting questions:

EDIT #2: This is just a note for people like me who had never used settings before. Settings are pretty useful, but I had to do a whole bunch of digging to figure out what was going on (coming from the Python world, not something I am used too). Things got complicated as I wanted to save dictionaries and apparently they can't be serialized. Settings also seem to get stored in 3 different files depending on what you do. There is an app.config, user.config and a settings.setting file. So here are two more links that I found useful:

Community
  • 1
  • 1
Sharun
  • 2,030
  • 4
  • 22
  • 36

4 Answers4

72

You can use the Application Settings easily enough.

If you haven't done so before just right click on the project and choose Properties. Select the Settings tab. Make sure you chose "User" for the scope (otherwise the setting is read-only).

The code to access this is simple:

forms.Width = Application1.Properties.Settings.Default.Width;

If you need to save it:

Application1.Properties.Settings.Default.Width = forms.Width;
Application1.Properties.Settings.Default.Save();

In the sample above, Width is the custom setting name you define in the Settings tab and Application1 is the Namespace of your application.

Edit: Responding to further questions

You mentioned you wanted to store Dictionary objects in the Settings. As you discovered, you can't do this directly because Dictionary objects are not serializable. However, you can create your own serializable dictionary pretty easily. Paul Welzer had an excellent example on his blog.

You have a couple of links which sort of muddy the situation a little. Your original question is where to save "User Preference Files". I'm pretty certain Microsoft's intention with the Settings functionality is exactly that... storing user skin preferences, layout choices, etc. It not meant as a generic repository for an application's data although it could be easily abused that way.

The data is stored in separate places for a good reason. Some of the settings are Application settings and are read-only. These are settings which the app needs to function but is not specific to a user (for example, URIs to app resources or maybe a tax rate). These are stored in the app.config.

User settings are stored in an obfuscated directory deep within the User Document/Settings folder. The defaults are stored in app.config (I think, can't recall for certain off the top of my head) but any user changes are stored in their personal folder. This is meant for data that changes from user to user. (By "user" I mean Windows user, not your app's user.)

Hope this clarified this somewhat for you. The system is actually pretty simple. It might seem a little foreign at first but after a few days of using it you'll never have to think of it again... it just works.

Sailing Judo
  • 11,083
  • 20
  • 66
  • 97
  • when you say access code is: forms.Width = Application1.Properties.Settings.Default.Width; Does this mean it loads Width that was possibly saved in a previous session? – Sharun Dec 28 '08 at 17:24
  • 1
    Yes, the little sample he provided will restore the previous width. If you're going to use it (along with height and position), make sure you have some checks to ensure the window is visible. Restoring the position is a bad feature for dual monitor users when they remove the second one. – Samuel Dec 28 '08 at 17:41
  • Yes... this sample was just the first thing that popped into my head. You can store almost anything in the settings, including arrays. I have a rather extreme app that stores a large deserialized List of objects. – Sailing Judo Dec 28 '08 at 19:40
  • What if you are saving dynamic settings? For example, if I an keeping track of screens that a user has open and their positions, these settings are dynamic. Does this require a different scenario? – Josh G Apr 28 '11 at 12:56
  • @Josh - No, you can do it the same way. It might not be the most efficient way for you but it will still work. – Sailing Judo Apr 28 '11 at 17:28
  • Did some research on that this morning. It looks like you can specify any object as a setting as long as it is TypeConvertable to/from string or XmlSerializable. The strange thing is that VS never lists any of your custom types as available in the settings pane, so you have to type in the complete namespace/type path. Works great though! – Josh G Apr 28 '11 at 18:47
28

When running as non-admin or on Vista you can't write to the "Program files" folder (or any sub folder of it).

The correct location to store user preference is (replace MyCompanyName and MyApplicationName with the correct names, obviously)

On disk:

Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData) + "\\MyCompanyName\\MyApplicationName"

Or in the registry under the key:

 HKEY_CURRENT_USER\Software\MyCompanyName\MyApplicationName

Those location are per-user and they work with non-admin user, several users using the same computer, fast user switching, terminal services and all the other ways people can interact with your software.

If you need a common location for all users then:

  1. It will only work when the user run as an administrator
  2. It will not work reliably on Vista
  3. You have to take care of everything yourself (like two users running the application on the same computer at the same time via fast user switching).

and the locations are:

Environment.GetFolderPath(Environment.SpecialFolder.ApplicationCommonData) + "\\MyCompanyName\\MyApplicationName"

Or in the registry under the key:

 HKEY_LOCAL_MACHINE\Software\MyCompanyName\MyApplicationName
Nir
  • 29,306
  • 10
  • 67
  • 103
3

You can use isolated storage. You can isolate by user, assembly and/or domain.

Introduction to Isolated Storage
http://msdn.microsoft.com/en-us/library/3ak841sy(VS.80).aspx

Types of Isolation
http://msdn.microsoft.com/en-us/library/eh5d60e1(VS.80).aspx

meklarian
  • 6,595
  • 1
  • 23
  • 49
Muad'Dib
  • 28,542
  • 5
  • 55
  • 68
1

the following seems to be the best option:

Application.UserAppDataPath
sth
  • 222,467
  • 53
  • 283
  • 367
Anne
  • 19
  • 1