Cette documentation est archivée et n’est pas conservée.

IPersistComponentSettings.SaveSettings, propriété

Remarque : cette propriété est nouvelle dans le .NET Framework version 2.0.

Obtient ou définit une valeur indiquant si le contrôle doit rendre ses données de configuration automatiquement persistantes.

Espace de noms : System.Configuration
Assembly : System (dans system.dll)

bool SaveSettings { get; set; }
/** @property */
boolean get_SaveSettings ()

/** @property */
void set_SaveSettings (boolean value)

function get SaveSettings () : boolean

function set SaveSettings (value : boolean)

Valeur de la propriété

true si le contrôle doit rendre son état automatiquement persistant ; sinon, false.

Si un contrôle contient des données de configuration, elles seront persistantes en général en réponse à un appel explicite à la méthode SaveComponentSettings ou parfois implicitement lorsque la méthode Dispose du contrôle est appelée. La propriété SaveSettings si un contrôle rend ses données de configuration automatiquement persistantes lorsqu'il est supprimé.

La valeur par défaut de SaveSettings dépend de l'implémentation du contrôle. La documentation relative au contrôle doit indiquer s'il utilise des paramètres d'application, quelles données sont persistantes, et quelle est la valeur par défaut de la propriété SaveSettings.

L'exemple de code suivant indique la méthode appropriée permettant à un contrôle de vérifier la valeur de la propriété SaveSettings avant d'essayer de rendre ses données de configuration automatiquement persistantes.

protected override void Dispose( bool disposing ) {

if(disposing) {

try {

if (SaveSettings) {

SaveComponentSettings();

}

}

finally {

//...

}

}

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0
Afficher: