Click here to Skip to main content
15,877,168 members
Articles / Programming Languages / C#
Article

How To Use the Settings Class in C#

Rate me:
Please Sign up or sign in to vote.
4.59/5 (78 votes)
15 Feb 2007CPOL4 min read 523.6K   104   57
A simple way to learn and start using the C# Settings class

Introduction

The first time I tried to store application settings using the Settings class that came with C#, I got stuck because the changed settings that I saved did not show up the next time I ran the application. I tried several times and eventually had to include another class into the project to accomplish saving the application state.

Recently while writing a project, I thought of how I would save the application settings and load it the next time the application is run. I didn't want to use my method for saving and loading the settings to and from disk - I wanted something ready-made. So the Settings class came to my mind again. Remembering my first experience with the class, I just wanted to chicken out, but due to the importance of saving the application's settings, I had to try it once more.

If I didn't make it, I would not have written this article. So enjoy it.

myApp.Properties.Settings

I'll walk you through the process of setting your program ( "myApp" ) to use the Settings class.

Click on the Project menu -> myApp Properties.

A new tab spawns showing you the various properties that can be set or read in the application you are currently building.

Click the Settings tab in the list of properties.

Enter the Settings you'd like to add (see the image below).

Settings Property page

When you type the name, you select the type, then you set the scope before you enter the value. You will have to take note of the Scope property. That is, in what 'scope' do you want the setting to be visible, is it at the user level (visible only to the current user) or at the application level (visible to the application from all user accounts). The logic is that if the scope is Application, once set you cannot change it from outside the IDE - you sure wouldn't want anything to tamper with what makes your program 'sane'. If the scope is User then it can be changed at runtime and the new value will be stored for you - which you can then read another time the program is run. This is exactly what most of us need from this class, no more no less. Once you're finished writing the name and setting the properties and values (make sure there is a default value you give to each name you 'declare'), click the Save button.

Using PostTracker.Properties.Settings

The main use of the Settings class comes up in your code. Let's assume the application we're working on is PostTracker and we have created the following settings names using the Settings Properties page: SmtpHost, Account, Password, Port.

Reading PostTracker.Properties.Settings

If you have created a usable setting that you want to save to disk, then it must be readable from the disk. Well, you don't have to worry about reading the settings from disk, it's automatically done for you, but you will need to get it from where it is stored. To do this, check out the code below:

C#
account = PostTracker.Properties.Settings.Default.Account;
host = PostTracker.Properties.Settings.Default.smtpHost;
password = PostTracker.Properties.Settings.Default.Password;
port = Convert.ToString( PostTracker.Properties.Settings.Default.Port );

Don't ever forget to have declared your variables and make sure they are visible in the code block before you use them. You also need to note that the responsibility to convert to the appropriate type when reading or saving rests on you.

You might be tempted to read this way;

C#
// No Compile time or runtime error will be generated at this line
// but account will hold no value
account = Properties.Settings.Default.Account;

Writing PostTracker.Properties.Settings

The following lines of code demonstrate how to save your settings to disk:

C#
PostTracker.Properties.Settings.Default.Account = account;
PostTracker.Properties.Settings.Default.smtpHost = host;
PostTracker.Properties.Settings.Default.Password = password;
PostTracker.Properties.Settings.Default.Port = Convert.ToInt16( port );
PostTracker.Properties.Settings.Default.Save( ); // Important for saving

You must remember to call the Save() method if you really mean to keep your application settings.

Additional Information

Maybe you plan to put up a Settings page for your application and you're thinking of how to write code that checks to see if one of the settings has been changed by the user so you make the "Apply" button active for the user or decide it's not yet time to make a particular button active on the form. Well, you'll only have to write a few lines of code.

Sample Settings Form

This code is only a guide. Similar code you write should be wired to the appropriate events from your controls.

C#
// The content of the TextBox that holds the user's password has just been changed
textboxPassword_TextChanged(object sender, EventArgs e)
{
    if(PostTracker.Properties.Settings.Default.Password || textboxPassword.Text
        // . . . check for other properties can ( and should ) come in here
        )
        {
            // Your action comes here, for example
            UpdateApplyButton();
        }
}
// You can wire other related events form related controls to the Method to save time

Conclusion

In conclusion, it's pretty simple and interesting to use the Settings class in your apps, but not knowing how to use it might just put you off the little treasure.

I really hope you enjoy this article. If you have questions or suggestions or corrections or ..., you're most welcome to send me an email.

Thank you.

History

  • 15th February, 2007: Initial post

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Web Developer TEDATA
Nigeria Nigeria
Seun (Laolusrael) loves programming. I learnt 80% of what I know in programming all alone. I use my God-given mind to do a lot of thinking, and...
Currently Seun is a student studying software engineering, and working freelance.

Comments and Discussions

 
QuestionSaving custom objects Pin
GroXx16-Sep-07 8:05
GroXx16-Sep-07 8:05 
GeneralBrilliant Pin
Dirk_Strauss9-Jul-07 3:44
professionalDirk_Strauss9-Jul-07 3:44 
GeneralRe: Brilliant Pin
Seun27-Jan-08 12:53
professionalSeun27-Jan-08 12:53 
QuestionSettings values Pin
DannyAdler8-May-07 1:35
DannyAdler8-May-07 1:35 
AnswerRe: Settings values Pin
Seun9-May-07 14:08
professionalSeun9-May-07 14:08 
AnswerRe: Settings values Pin
DannyAdler9-May-07 22:08
DannyAdler9-May-07 22:08 
GeneralRe: Settings values Pin
Seun10-May-07 13:54
professionalSeun10-May-07 13:54 
GeneralGreat Tip - Good explaination Pin
buyValu7-May-07 7:27
buyValu7-May-07 7:27 
I appreciate your posting this code/tip. I searched the net looking for just such an example. As always Microsoft Help is practically useless.

Thanks again Big Grin | :-D
Generalregistry Pin
riscy21-Feb-07 19:10
riscy21-Feb-07 19:10 
GeneralRe: registry Pin
Seun23-Feb-07 11:00
professionalSeun23-Feb-07 11:00 
GeneralRe: registry Pin
Matware26-Feb-07 15:56
Matware26-Feb-07 15:56 
GeneralRe: registry Pin
Seun15-Mar-07 23:42
professionalSeun15-Mar-07 23:42 
GeneralRe: registry Pin
Taneth4-Dec-07 8:31
professionalTaneth4-Dec-07 8:31 
GeneralRe: registry Pin
cobses24-Nov-08 16:09
cobses24-Nov-08 16:09 
GeneralGood article at the proper time Pin
redjoy15-Feb-07 15:43
redjoy15-Feb-07 15:43 

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.