IPersistComponentSettings.SaveSettings Propriedade
Definição
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.Gets or sets a value indicating whether the control should automatically persist its application settings properties.
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 .true if the control should automatically persist its state; otherwise, false.
Exemplos
O exemplo de código a seguir mostra a maneira apropriada para um controle verificar o valor da SaveSettings propriedade antes de tentar persistir automaticamente seus dados de configuração.The following code example shows the proper way for a control to check the value of the SaveSettings property before it attempts to automatically persist its configuration data.
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 manterá esses dados em resposta a uma chamada explícita para o SaveComponentSettings método ou, às vezes, implicitamente quando o método do controle Dispose é invocado.If a control contains configuration data, it will typically persist this data in response to an explicit call to the SaveComponentSettings method or sometimes implicitly when the control's Dispose method is invoked. A SaveSettings propriedade determina se um controle persiste automaticamente seus dados de configuração quando ele é Descartado.The SaveSettings property determines whether a control automatically persists its configuration data when it is disposed.
O valor padrão de SaveSettings depende da implementação do controle.The default value of SaveSettings depends on the implementation of the control. A documentação do controle deve indicar se ele usa as configurações do aplicativo, quais dados são persistidos e qual é o valor padrão da SaveSettings propriedade.The documentation for the control should indicate whether it uses application settings, what data is persisted, and what the default value of the SaveSettings property is.