IPersistComponentSettings.SaveSettings Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um valor que indica se o controle deve ou não persistir automaticamente as propriedades de configurações de aplicativo dele.
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
Valor da propriedade
true
se o controle deve persistir automaticamente seu estado; caso contrário, false
.
Exemplos
O exemplo de código a seguir mostra a maneira adequada para um controle marcar o valor da propriedade antes de SaveSettings tentar persistir automaticamente seus dados de configuração.
protected override void Dispose( bool disposing ) {
if(disposing) {
try {
if (SaveSettings) {
SaveComponentSettings();
}
}
finally {
//...
}
}
Comentários
Se um controle contiver dados de configuração, ele normalmente persistirá esses dados em resposta a uma chamada explícita ao SaveComponentSettings método ou às vezes implicitamente quando o método do Dispose controle é invocado. A SaveSettings propriedade determina se um controle persiste automaticamente seus dados de configuração quando ele é descartado.
O valor padrão de SaveSettings depende da implementação do controle . A documentação do controle deve indicar se ele usa configurações de aplicativo, quais dados são persistentes e qual é o valor padrão da SaveSettings propriedade.