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

Boolean

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.

Aplica-se a

Confira também