LocalFileSettingsProvider.SetPropertyValues Método

Definición

Espacio de nombres:

System.Configuration

Ensamblado:

System.Configuration.ConfigurationManager.dll

Paquete:

System.Configuration.ConfigurationManager v8.0.0

Source:

LocalFileSettingsProvider.cs

Establece los valores del grupo especificado de valores de propiedades.

public:
 override void SetPropertyValues(System::Configuration::SettingsContext ^ context, System::Configuration::SettingsPropertyValueCollection ^ values);

public override void SetPropertyValues (System.Configuration.SettingsContext context, System.Configuration.SettingsPropertyValueCollection values);

override this.SetPropertyValues : System.Configuration.SettingsContext * System.Configuration.SettingsPropertyValueCollection -> unit

Public Overrides Sub SetPropertyValues (context As SettingsContext, values As SettingsPropertyValueCollection)

Parámetros

context

SettingsContext

Objeto SettingsContext que describe el uso de la aplicación actual.

values

SettingsPropertyValueCollection

Objeto SettingsPropertyValueCollection que representa el grupo de valores de propiedades que se va a establecer.

Excepciones

ConfigurationErrorsException

Se ha detectado una configuración con ámbito de usuario pero la configuración actual sólo admite valores de configuración con ámbito de aplicación.

o bien

Se ha producido un error general al guardar la configuración en el archivo de configuración.

Comentarios

Una clase contenedora de configuración, derivada de ApplicationSettingsBase, contiene el Save método , al que se llama para conservar los valores de todas sus propiedades de configuración. Este método enumera todos los proveedores de configuración asociados a sus propiedades de configuración y llama al SetPropertyValues método para que realice SettingsProvider la operación de serialización real.

SetPropertyValues serializa individualmente cada propiedad de configuración de aplicación con ámbito de usuario en su configuración de aplicación correspondiente en el archivo de configuración adecuado user.config .

De forma predeterminada, el SetPropertyValues método usa la siguiente secuencia lógica para determinar el esquema de serialización, en función del tipo de la propiedad settings:

1. Si el tipo tiene asociado TypeConverter a una ConvertToString implementación de método, se usa esta conversión.

2. Se usa la serialización XML.

Sin embargo, puede especificar un mecanismo de serialización preferido mediante SettingsSerializeAsAttribute. LocalFileSettingsProvider no admite la serialización binaria en Visual Studio 2005.

Si una propiedad de configuración con ámbito de usuario se vuelve a establecer explícitamente en su valor predeterminado, el proveedor de configuración de archivo local quitará la entrada para la configuración asociada del archivo de configuración de usuario. El siguiente acceso de lectura para esta propiedad simplemente usará el valor predeterminado.

Precaución

LocalFileSettingsProvider no usa el cifrado para conservar ninguna configuración. Por lo tanto, no almacene contraseñas de texto sin formato u otra información confidencial con este proveedor sin tomar precauciones adicionales, como cifrar por separado la información dentro del archivo de configuración. Para obtener más información, vea Cifrar la información de configuración mediante la configuración protegida.

Consulte también

• GetPropertyValues(SettingsContext, SettingsPropertyCollection)
• Save()
• TypeConverter
• SettingsSerializeAsAttribute