ApplicationSettingsBase.Save Método
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.
Armazena os valores atuais das propriedades de configurações do aplicativo.
public:
override void Save();public override void Save ();override this.Save : unit -> unitPublic 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.
