ApplicationSettingsBase.Save Método

Definição

Armazena os valores atuais das propriedades das definições da aplicação.

public:
 override void Save();
public override void Save();
override this.Save : unit -> unit
Public Overrides Sub Save ()

Exemplos

O seguinte exemplo de código mostra o Save método a ser chamado pelo Closing gestor de eventos para a forma primária. Este método também acrescenta um período extra à propriedade de definições associada à propriedade do Text formulário.

O exemplo completo do código está listado na ApplicationSettingsBase visão geral da 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 = Text + "."c

    ' Save size settings manually.
    frmSettings1.FormSize = Size

    frmSettings1.Save()
End Sub

Observações

O Save método escreve o valor atual de cada propriedade de definições no seu armazenamento de dados associado. Para cada propriedade, este método chama o SetPropertyValues método no fornecedor de definições associado.

Este método difere da implementação da classe base porque eleva o SettingsSaving evento antes de os valores serem escritos.

Se as únicas definições definidas forem definidas por aplicação, Save não terá efeito e não devolverá erro se for chamado com o padrão LocalFileSettingsProvider. LocalFileSettingsProvider Só guarda as definições com escopo do utilizador.

Importante

Não existe um método Load correspondente porque os valores das definições da aplicação são automaticamente carregados durante a inicialização da classe wrapper. Em contraste, estes valores não são guardados automaticamente quando uma aplicação termina. Por isso, deve chamar explicitamente o Save método para manter os valores atuais das definições da aplicação. Isto é normalmente realizado no Closing gestor de eventos do primário ou que contém Form.

Aplica-se a

Ver também