How to: Change User Settings in Visual Basic
Updated: July 20, 2015
For the latest documentation on Visual Studio 2017 RC, see Visual Studio 2017 RC Documentation.
You can change a user setting by assigning a new value to the setting's property on the
My.Settings object exposes each setting as a property. The property name is the same as the setting name, and the property type is the same as the setting type. The setting's Scope determines if the property is read-only: The property for an Application-scope setting is read-only, while the property for a User-scope setting is read-write. For more information, see My.Settings Object.
Although you can change and save the values of user-scope settings at run time, application-scope settings are read-only and cannot be changed programmatically. You can change application-scope settings when you create the application by using the Project Designer or by editing the application's configuration file. For more information, see Managing Application Settings (.NET).
This example changes the value of the
Nickname user setting.
For this example to work, your application must have a
Nickname user setting, of type
The application saves the user settings when the application shuts down. To save the settings immediately, call the
My.Settings.Save method. For more information, see How to: Persist User Settings in Visual Basic.
How to: Read Application Settings in Visual Basic
How to: Persist User Settings in Visual Basic
How to: Create Property Grids for User Settings in Visual Basic
Managing Application Settings (.NET)