ApplicationSettingsBase.Save 方法

定義

命名空間:

System.Configuration

組件:

System.Configuration.ConfigurationManager.dll

來源:

ApplicationSettingsBase.cs

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

public:
 override void Save();

public override void Save();

override this.Save : unit -> unit

Public Overrides Sub Save ()

範例

以下程式碼範例展示了主要表單的Closing事件處理程序呼叫的方法Save。 此方法也會在與表單 Text 屬性相關的設定屬性後附加一個額外的句號。

完整程式碼範例列於 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 = Text + "."c

    ' Save size settings manually.
    frmSettings1.FormSize = Size

    frmSettings1.Save()
End Sub

備註

此 Save 方法會將每個設定屬性的當前值寫入其對應的資料儲存庫。 對於每個屬性，此方法呼叫相關設定提供者的方法 SetPropertyValues 。

此方法與基底類別實作不同，因為它會在 SettingsSaving 寫入值之前先提出事件。

如果只定義了應用程式範圍的設定， Save 則在使用預設 LocalFileSettingsProvider時，將不會產生影響且不會回傳錯誤。 LocalFileSettingsProvider 只會儲存使用者的範圍設定。

這很重要

沒有對應的載入方法，因為應用程式設定的值會在包裝類別初始化時自動載入。 相較之下，這些值在應用程式結束時不會自動儲存。 因此，你必須明確呼叫該 Save 方法來持久化應用程式設定的當前值。 這通常在 Closing 主事件處理程序中執行，或包含 Form。

另請參閱

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