LocalFileSettingsProvider.SetPropertyValues Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit les valeurs du groupe spécifié de paramètres de propriété.
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)Paramètres
- context
- SettingsContext
Description SettingsContext de l’utilisation actuelle de l’application.
Représentant SettingsPropertyValueCollection le groupe de paramètres de propriété à définir.
Exceptions
Un paramètre d’étendue utilisateur a été rencontré, mais la configuration actuelle prend uniquement en charge les paramètres d’étendue de l’application.
- ou -
Un échec général s’est produit 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, 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 chacune SettingsProvider d’elles pour effectuer l’opération de sérialisation réelle.
SetPropertyValues sérialise individuellement chaque propriété de paramètres d’application délimitée par 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 :
Si le type est associé à TypeConverter une ConvertToString implémentation de méthode, cette conversion est utilisée.
La sérialisation XML est utilisée.
Toutefois, vous pouvez spécifier un mécanisme de sérialisation préféré à l’aide du SettingsSerializeAsAttribute. LocalFileSettingsProvider ne prend pas en charge la sérialisation binaire dans Visual Studio 2005.
Si une propriété de paramètres d’étendue utilisateur est définie explicitement 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é utilise simplement la valeur par défaut.
Avertissement
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 distinct des informations dans le fichier de configuration.
