ApplicationSettingsBase.Save Método

Definição

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacote:

System.Configuration.ConfigurationManager v8.0.0

Origem:

ApplicationSettingsBase.cs

Armazena os valores atuais das propriedades de configurações do aplicativo.

public:
 override void Save();

public override void Save ();

override this.Save : unit -> unit

Public Overrides Sub Save ()

Exemplos

O exemplo de código a seguir mostra o Save método que está sendo chamado do Closing manipulador de eventos para o formulário primário. Esse método também acrescenta um período extra à propriedade settings associada à propriedade do Text formulário.

O exemplo de código completo está listado na visão geral da ApplicationSettingsBase classe.

private:
    void AppSettingsForm_FormClosing(Object^ sender,
        FormClosingEventArgs^ e)
    {
        //Synchronize manual associations first.
        formSettings->FormText = this->Text + '.';
        formSettings->Save();
    }

private void Form1_FormClosing(object sender, FormClosingEventArgs e)
{
    //Synchronize manual associations first.
    frmSettings1.FormText = this.Text + '.';
    frmSettings1.FormSize = this.Size;
    frmSettings1.Save();
}

Private Sub Form1_FormClosing_1(ByVal sender As Object, ByVal e As _
        FormClosingEventArgs) Handles MyBase.FormClosing
    'Synchronize manual associations first.
    frmSettings1.FormText = Me.Text + "."c

    ' Save size settings manually.
    frmSettings1.FormSize = Me.Size

    frmSettings1.Save()
End Sub

Comentários

O Save método grava o valor atual de cada propriedade de configurações em seu armazenamento de dados associado. Para cada propriedade, esse método chama o SetPropertyValues método no provedor de configurações associado.

Esse método difere da implementação da classe base, pois gera o SettingsSaving evento antes que os valores sejam gravados.

Se as únicas configurações definidas forem configurações no escopo do aplicativo, Save não terá efeito e não retornará nenhum erro se for chamado com o padrão LocalFileSettingsProvider. LocalFileSettingsProvider salva apenas as configurações no escopo do usuário.

Importante

Não há nenhum método Load correspondente porque os valores das configurações do aplicativo são carregados automaticamente durante a inicialização da classe wrapper. Por outro lado, esses valores não são salvos automaticamente quando um aplicativo termina. Portanto, você deve chamar explicitamente o Save método para persistir os valores atuais das configurações do aplicativo. Normalmente, isso é executado no Closing manipulador de eventos do primário ou que contém Form.

Confira também

• Reset()
• Reload()
• SettingsSaving
• SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)
• SettingsProviderAttribute