LocalFileSettingsProvider.SetPropertyValues Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> unitPublic Overrides Sub SetPropertyValues (context As SettingsContext, values As SettingsPropertyValueCollection)Parámetros
- context
- SettingsContext
Objeto SettingsContext que describe el uso de la aplicación actual.
Objeto SettingsPropertyValueCollection que representa el grupo de valores de propiedades que se va a establecer.
Excepciones
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:
Si el tipo tiene asociado TypeConverter a una ConvertToString implementación de método, se usa esta conversión.
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.
