ApplicationSettingsBase.Save Yöntem

Tanım

Ad Alanı:

System.Configuration

Bütünleştirilmiş Kod:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Kaynak:

ApplicationSettingsBase.cs

Uygulama ayarları özelliklerinin geçerli değerlerini depolar.

public:
 override void Save();

public override void Save ();

override this.Save : unit -> unit

Public Overrides Sub Save ()

Örnekler

Aşağıdaki kod örneği, birincil formun SaveClosing olay işleyicisinden çağrılan yöntemi gösterir. Bu yöntem ayrıca formun Text özelliğiyle ilişkili settings özelliğine fazladan bir süre ekler.

Tam kod örneği, sınıfa ApplicationSettingsBase genel bakış bölümünde listelenmiştir.

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

Açıklamalar

yöntemi, Save her ayarlar özelliğinin geçerli değerini ilişkili veri deposuna yazar. Her özellik için bu yöntem, ilişkili ayarlar sağlayıcısında yöntemini çağırır SetPropertyValues .

Bu yöntem, temel sınıf uygulamasından farklıdır ve değerler yazilmeden önce olayı tetikler SettingsSaving .

Tanımlanan tek ayarlar uygulama kapsamlı ayarlarsa, Save hiçbir etkisi olmaz ve varsayılan LocalFileSettingsProviderile çağrılırsa hata döndürmez. LocalFileSettingsProvider yalnızca kullanıcı kapsamlı ayarları kaydeder.

Önemli

Sarmalayıcı sınıfı başlatma sırasında uygulama ayarlarının değerleri otomatik olarak yüklendiğinden karşılık gelen bir Load yöntemi yoktur. Buna karşılık, bir uygulama sona erdiğinde bu değerler otomatik olarak kaydedilmez. Bu nedenle, uygulama ayarlarının Save geçerli değerlerini kalıcı hale getirmek için yöntemini açıkça çağırmanız gerekir. Bu genellikle birincil veya içeren Formolay işleyicisinde Closing gerçekleştirilir.

Ayrıca bkz.

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