IPersistComponentSettings.SaveSettings Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta un valore che indica se le proprietà delle impostazioni dell'applicazione del controllo devono essere mantenute automaticamente.
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
Valore della proprietà
true
se lo stato del controllo deve essere mantenuto in modo automatico; in caso contrario, false
.
Esempio
Nell'esempio di codice seguente viene illustrato il modo appropriato per un controllo per controllare il valore della proprietà prima di tentare di rendere persistenti automaticamente i dati di SaveSettings configurazione.
protected override void Dispose( bool disposing ) {
if(disposing) {
try {
if (SaveSettings) {
SaveComponentSettings();
}
}
finally {
//...
}
}
Commenti
Se un controllo contiene dati di configurazione, questi dati verranno in genere mantenuti in risposta a una chiamata esplicita al SaveComponentSettings metodo o talvolta in modo implicito quando viene richiamato il metodo del Dispose controllo. La SaveSettings proprietà determina se un controllo mantiene automaticamente i dati di configurazione quando viene eliminato.
Il valore predefinito di SaveSettings dipende dall'implementazione del controllo. La documentazione del controllo deve indicare se usa le impostazioni dell'applicazione, i dati persistenti e il valore predefinito della SaveSettings proprietà.