IPersistComponentSettings.SaveSettings Propriété
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.
Obtient ou définit une valeur indiquant si le contrôle doit rendre ses données de configuration automatiquement persistantes.
public:
property bool SaveSettings { bool get(); void set(bool value); };
public bool SaveSettings { get; set; }
member this.SaveSettings : bool with get, set
Public Property SaveSettings As Boolean
Valeur de propriété
true
si le contrôle doit rendre son état automatiquement persistant ; sinon, false
.
Exemples
L’exemple de code suivant montre la façon appropriée pour un contrôle de case activée la valeur de la SaveSettings propriété avant qu’il tente de conserver automatiquement ses données de configuration.
protected override void Dispose( bool disposing ) {
if(disposing) {
try {
if (SaveSettings) {
SaveComponentSettings();
}
}
finally {
//...
}
}
Remarques
Si un contrôle contient des données de configuration, il conserve généralement ces données en réponse à un appel explicite à la SaveComponentSettings méthode ou parfois implicitement lorsque la méthode du Dispose contrôle est appelée. La SaveSettings propriété détermine si un contrôle conserve automatiquement ses données de configuration lorsqu’il est supprimé.
La valeur par défaut de dépend de SaveSettings l’implémentation du contrôle. La documentation du contrôle doit indiquer s’il utilise les paramètres de l’application, quelles données sont conservées et quelle est la valeur par défaut de la SaveSettings propriété.