LocalFileSettingsProvider.SetPropertyValues Méthode

Définition

Espace de noms:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Définit les valeurs du groupe de paramètres de propriétés spécifié.

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)

Paramètres

context

SettingsContext

SettingsContext décrivant l'utilisation de l'application actuelle.

values

SettingsPropertyValueCollection

SettingsPropertyValueCollection représentant le groupe de paramètres de propriétés à définir.

Exceptions

ConfigurationErrorsException

Un paramètre de portée utilisateur a été rencontré, mais la configuration actuelle prend en charge uniquement les paramètres de portée application.

- ou -

Une défaillance générale s'est produite lors de l'enregistrement des paramètres dans le fichier de configuration.

Remarques

Une classe wrapper de paramètres, dérivée de ApplicationSettingsBase, contient la Save méthode , qui est appelée pour conserver les valeurs de toutes ses propriétés de paramètres. Cette méthode énumère tous les fournisseurs de paramètres associés à ses propriétés de paramètres et appelle la SetPropertyValues méthode pour chacun SettingsProvider d’eux afin d’effectuer l’opération de sérialisation réelle.

SetPropertyValues sérialise individuellement chaque propriété de paramètres d’application étendue à l’utilisateur à son paramètre d’application correspondant dans le fichier de configuration approprié user.config .

Par défaut, la SetPropertyValues méthode utilise la séquence logique suivante pour déterminer le schéma de sérialisation, en fonction du type de la propriété settings :

1. Si le type a un associé à TypeConverter une ConvertToString implémentation de méthode, cette conversion est utilisée.

2. La sérialisation XML est utilisée.

Toutefois, vous pouvez spécifier un mécanisme de sérialisation préféré à l’aide de SettingsSerializeAsAttribute. LocalFileSettingsProvider ne prend pas en charge la sérialisation binaire dans Visual Studio 2005.

Si une propriété de paramètres étendues à l’utilisateur est explicitement définie sur sa valeur par défaut, le fournisseur de paramètres de fichier local supprime l’entrée du paramètre associé du fichier de configuration utilisateur. L’accès en lecture suivant pour cette propriété utilisera simplement la valeur par défaut.

Attention

LocalFileSettingsProvider n’utilise pas le chiffrement pour conserver les paramètres. Par conséquent, ne stockez pas de mots de passe en texte brut ou d’autres informations sensibles à l’aide de ce fournisseur sans prendre de précautions supplémentaires, telles que le chiffrement séparé des informations dans le fichier de configuration. Pour plus d’informations, consultez Chiffrement des informations de configuration à l’aide de la configuration protégée.

Voir aussi

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