ApplicationSettingsBase.Save 方法

定義

命名空間:

System.Configuration

組件:

System.Configuration.ConfigurationManager.dll

套件:

System.Configuration.ConfigurationManager v8.0.0

來源:

ApplicationSettingsBase.cs

儲存應用程式設定屬性的目前值。

public:
 override void Save();

public override void Save ();

override this.Save : unit -> unit

Public Overrides Sub Save ()

範例

下列程式代碼範例顯示 Save 從 Closing 主要表單的事件處理程式呼叫的方法。 這個方法也會將額外的期間附加至與窗體 Text 屬性相關聯的 settings 屬性。

完整的程式代碼範例會列在類別概觀中 ApplicationSettingsBase 。

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

備註

方法 Save 會將每個 settings 屬性的目前值寫入其相關聯的數據存放區。 針對每個屬性，這個方法會在相關聯的設定提供者上呼叫 SetPropertyValues 方法。

這個方法與基類實作不同，因為它會在 SettingsSaving 寫入值之前引發 事件。

如果唯一定義的設定是應用程式範圍的設定，則不會有任何作用， Save 如果以預設 LocalFileSettingsProvider呼叫 ，則不會傳回任何錯誤。 LocalFileSettingsProvider 只會儲存用戶範圍設定。

重要

沒有對應的Load方法，因為應用程式設定的值會在包裝函式類別初始化期間自動載入。 相反地，這些值不會在應用程式結束時自動儲存。 因此，您必須明確呼叫 方法， Save 才能保存應用程式設定的目前值。 這通常會在主要或包含Form的事件處理程序中Closing執行。

另請參閱

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