LocalFileSettingsProvider.SetPropertyValues Method (SettingsContext, SettingsPropertyValueCollection)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Sets the values of the specified group of property settings.

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

public override void SetPropertyValues(
	SettingsContext context,
	SettingsPropertyValueCollection values


Type: System.Configuration.SettingsContext

A SettingsContext describing the current application usage.

Type: System.Configuration.SettingsPropertyValueCollection

A SettingsPropertyValueCollection representing the group of property settings to set.

Exception Condition

A user-scoped setting was encountered but the current configuration only supports application-scoped settings.


There was a general failure saving the settings to the configuration file.

A settings wrapper class, derived from ApplicationSettingsBase, contains the Save method, which is called to persist the values of all of its settings properties. This method enumerates through all the settings providers associated with its settings properties, and calls the SetPropertyValues method for each SettingsProvider to perform the actual serialization operation.

SetPropertyValues individually serializes each user-scoped application settings property to its corresponding application setting in the appropriate user.config configuration file.

By default, the SetPropertyValues method uses the following logical sequence to determine the serialization scheme, depending on type of the settings property:

  1. If the type has an associated TypeConverter with a ConvertToString method implementation, this conversion is used.

  2. XML serialization is used.

However, you can specify a preferred serialization mechanism by using the SettingsSerializeAsAttribute. LocalFileSettingsProvider does not support binary serialization in Visual Studio 2005.

If a user-scoped settings property is set back to its default value explicitly, then the local file settings provider will remove the entry for the associated setting from the user configuration file. The next read access for this property will simply use the default value.


LocalFileSettingsProvider does not use encryption to persist any settings. Therefore, do not store plain text passwords or other sensitive information using this provider without taking additional precautions, such as separately encrypting the information within the configuration file. For more information, see Encrypting Configuration Information Using Protected Configuration.

.NET Framework
Available since 2.0
Return to top