ApplicationSettingsBase.Save Método
Definição
Armazena os valores atuais das propriedades de configurações do aplicativo.Stores the current values of the application settings properties.
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.The following code example shows the Save method being called from the Closing event handler for the primary form. Esse método também acrescenta um período extra à propriedade de configurações associada à propriedade do formulário Text .This method also appends an extra period to the settings property that is associated with the form's Text property.
O exemplo de código completo é listado na ApplicationSettingsBase visão geral da classe.The full code example is listed in the ApplicationSettingsBase class overview.
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.The Save method writes the current value of each settings property to its associated data store. Para cada propriedade, esse método chama o SetPropertyValues método no provedor de configurações associado.For each property, this method calls the SetPropertyValues method on the associated settings provider.
Esse método difere da implementação da classe base, pois gera o SettingsSaving evento antes que os valores sejam gravados.This method differs from the base class implementation in that it raises the SettingsSaving event before the values are written.
Se as únicas configurações definidas forem configurações no escopo do aplicativo, o Save não terá efeito e não retornará nenhum erro se for chamado com o padrão LocalFileSettingsProvider .If the only settings defined are application-scoped settings, Save will have no effect and return no error if called with the default LocalFileSettingsProvider. LocalFileSettingsProvider salva apenas as configurações no escopo do usuário.LocalFileSettingsProvider only saves user-scoped settings.
Importante
Não há nenhum método de carregamento correspondente porque os valores das configurações do aplicativo são carregados automaticamente durante a inicialização da classe de wrapper.There is no corresponding Load method because the values of application settings are automatically loaded during wrapper class initialization. Por outro lado, esses valores não são salvos automaticamente quando um aplicativo termina.In contrast, these values are not automatically saved when an application ends. Portanto, você deve chamar explicitamente o Save método para persistir os valores atuais das configurações do aplicativo.Therefore, you must explicitly call the Save method to persist the current values of the application settings. Normalmente, isso é executado no Closing manipulador de eventos do primário ou que o contém Form .This is typically performed in the Closing event handler of the primary or containing Form.