ApplicationSettingsBase.Reset Method

Restores the persisted application settings values to their corresponding default properties.

Namespace:  System.Configuration
Assembly:  System (in System.dll)

public void Reset()

ExceptionCondition
ConfigurationErrorsException

The configuration file could not be parsed.

The Reset method overwrites the user-scoped settings properties by restoring the currently persisted value of each application settings. This method performs the following actions:

Reload contrasts with Reset in that the former will load the last set of saved application settings values, whereas the latter will load the saved default values.

The following code example shows the Reset method being invoked in the body of the Click event handler for a button named btnReset. As a result of this call, the stored default values for the application settings are reloaded into their corresponding properties. The full code example is listed in the ApplicationSettingsBase class overview.

private void btnReset_Click(object sender, EventArgs e)
{
    frmSettings1.Reset();
    this.BackColor = SystemColors.Control;
}

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft