IPersistComponentSettings.SaveSettings Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define um valor que indica se o controlo deve persistir automaticamente as propriedades das suas definições de aplicação.
public:
property bool SaveSettings { bool get(); void set(bool value); };public bool SaveSettings { get; set; }member this.SaveSettings : bool with get, setPublic Property SaveSettings As BooleanValor de Propriedade
true se o controlo persistir automaticamente o seu estado; caso contrário, false.
Exemplos
O exemplo de código seguinte mostra a forma correta de um controlo verificar o valor da SaveSettings propriedade antes de tentar persistir automaticamente os seus dados de configuração.
protected override void Dispose( bool disposing ) {
if(disposing) {
try {
if (SaveSettings) {
SaveComponentSettings();
}
}
finally {
//...
}
}
Observações
Se um controlo contiver dados de configuração, normalmente persiste esses dados em resposta a uma chamada explícita ao SaveComponentSettings método ou, por vezes, implicitamente quando o método do Dispose controlo é invocado. A SaveSettings propriedade determina se um controlo persiste automaticamente os seus dados de configuração quando é descartado.
O valor padrão de SaveSettings depende da implementação do controlo. A documentação do controlo deve indicar se utiliza as definições da aplicação, que dados são mantidos e qual é o valor padrão da SaveSettings propriedade.