ApplicationSettingsBase 類別

定義

做為衍生實體包裝函式類別的基底類別,以實作 Windows Form 應用程式中的應用程式設定功能。Acts as a base class for deriving concrete wrapper classes to implement the application settings feature in Window Forms applications.

public ref class ApplicationSettingsBase abstract : System::Configuration::SettingsBase, System::ComponentModel::INotifyPropertyChanged
public abstract class ApplicationSettingsBase : System.Configuration.SettingsBase, System.ComponentModel.INotifyPropertyChanged
type ApplicationSettingsBase = class
    inherit SettingsBase
    interface INotifyPropertyChanged
Public MustInherit Class ApplicationSettingsBase
Inherits SettingsBase
Implements INotifyPropertyChanged
繼承
ApplicationSettingsBase
實作

範例

下列程式碼範例示範如何使用應用程式設定來保存主要表單的下列屬性:位置、大小、背景色彩和標題列文字。The following code example demonstrates the use of application settings to persist the following attributes of the main form: location, size, background color, and title bar text. 所有這些屬性會分別保存為 FormSettings 類別中的單一應用程式設定屬性,名為 FormLocationFormSizeFormBackColorFormTextAll of these attributes are persisted as single application settings properties in the FormSettings class, named FormLocation, FormSize, FormBackColor and FormText, respectively. 除了 FormTextSize 以外的所有資料都會系結至其相關聯的表單內容,並具有使用 DefaultSettingValueAttribute套用的預設設定值。All except for FormText and Size are data bound to their associated form properties and have a default setting value applied using DefaultSettingValueAttribute.

此表單包含四個具有下列名稱和函式的子控制項:The form contains four child controls that have the following names and functions:

  • 名為 btnBackColor 的按鈕,用來顯示 [色彩通用] 對話方塊。A button named btnBackColor used to display the Color common dialog box.

  • 名為 btnReload 的按鈕,用來 Reload 應用程式設定。A button named btnReload used to Reload the application settings.

  • 名為 btnReset 的按鈕,用來 Reset 應用程式設定。A button named btnReset used to Reset the application settings.

  • 名為 tbStatus 的 textbox,用來顯示程式的狀態資訊。A textbox named tbStatus used to display status information about the program.

請注意,在每次執行應用程式之後,會將額外的句點字元附加至表單的標題文字。Notice that after every execution of the application, an additional period character is appended to the title text of the form.

這個程式碼範例需要一個表單,其中具有名為 colorDialog1ColorDialog 類別,以及一個 ToolStripStatusLabel 名為 tbStatusStatusStrip 控制項。This code example requires a Form with a ColorDialog class named colorDialog1, and a StatusStrip control with a ToolStripStatusLabel named tbStatus. 此外,它需要三個名為 btnReloadbtnResetbtnBackColorButton 物件。Additionally, it requires three Button objects named btnReload, btnReset, and btnBackColor.


#using <System.dll>
#using <System.Drawing.dll>
#using <System.Windows.Forms.dll>

using namespace System;
using namespace System::ComponentModel;
using namespace System::Drawing;
using namespace System::Configuration;
using namespace System::Windows::Forms;

namespace AppSettingsSample
{
    //Application settings wrapper class
    ref class FormSettings sealed: public ApplicationSettingsBase
    {
    public:
        [UserScopedSettingAttribute()]
        property String^ FormText
        {
            String^ get()
            {
                return (String^)this["FormText"];
            }
            void set( String^ value )
            {
                this["FormText"] = value;
            }
        }

    public:
        [UserScopedSettingAttribute()]
        [DefaultSettingValueAttribute("0, 0")]
        property Point FormLocation
        {
            Point get()
            {
                return (Point)(this["FormLocation"]);
            }
            void set( Point value )
            {
                this["FormLocation"] = value;
            }
        }

    public:
        [UserScopedSettingAttribute()]
        [DefaultSettingValueAttribute("225, 200")]
        property Size FormSize
        {
            Size get()
            {
                return (Size)this["FormSize"];
            }
            void set( Size value )
            {
                this["FormSize"] = value;
            }
        }

    public:
        [UserScopedSettingAttribute()]
        [DefaultSettingValueAttribute("LightGray")]
        property Color FormBackColor
        {
            Color get()
            {
                return (Color)this["FormBackColor"];
            }
            void set(Color value)
            {
                this["FormBackColor"] = value;
            }
        }

    };

    ref class AppSettingsForm : Form
    {
        /// <summary>
        /// Required designer variable.
        /// </summary>
    private:
        System::ComponentModel::IContainer^ components;

        /// <summary>
        /// Clean up any resources being used. The Dispose(true) 
        /// pattern for embedded objects is implemented with this
        /// code that just contains a destructor 
        /// </summary>
    public:
        ~AppSettingsForm()
        {
            if (components != nullptr)
            {
                delete components;
            }
        }

#pragma region Windows Form Designer generated code

        /// <summary>
        /// Required method for Designer support - do not modify
        /// the contents of this method with the code editor.
        /// </summary>
    private:
        void InitializeComponent()
        {
            this->components = nullptr;
            this->colorDialog = gcnew System::Windows::Forms::ColorDialog();
            this->backColorButton = gcnew System::Windows::Forms::Button();
            this->resetButton = gcnew System::Windows::Forms::Button();
            this->statusDisplay = gcnew System::Windows::Forms::TextBox();
            this->reloadButton = gcnew System::Windows::Forms::Button();
            this->SuspendLayout();
            //
            // backColorButton
            //
            this->backColorButton->Location = System::Drawing::Point(26, 24);
            this->backColorButton->Name = "backColorButton";
            this->backColorButton->Size = System::Drawing::Size(159, 23);
            this->backColorButton->TabIndex = 0;
            this->backColorButton->Text = "Change Background Color";
            this->backColorButton->Click += gcnew System::EventHandler
                (this,&AppSettingsForm::BackColorButton_Click);
            //
            // resetButton
            //
            this->resetButton->Location = System::Drawing::Point(26, 90);
            this->resetButton->Name = "resetButton";
            this->resetButton->Size = System::Drawing::Size(159, 23);
            this->resetButton->TabIndex = 1;
            this->resetButton->Text = "Reset to Defaults";
            this->resetButton->Click += gcnew System::EventHandler
                (this,&AppSettingsForm::ResetButton_Click);
            //
            // statusDisplay
            //
            this->statusDisplay->Location = System::Drawing::Point(26, 123);
            this->statusDisplay->Name = "statusDisplay";
            this->statusDisplay->Size = System::Drawing::Size(159, 20);
            this->statusDisplay->TabIndex = 2;
            //
            // reloadButton
            //
            this->reloadButton->Location = System::Drawing::Point(26, 57);
            this->reloadButton->Name = "reloadButton";
            this->reloadButton->Size = System::Drawing::Size(159, 23);
            this->reloadButton->TabIndex = 3;
            this->reloadButton->Text = "Reload from Storage";
            this->reloadButton->Click += gcnew System::EventHandler
                (this,&AppSettingsForm::ReloadButton_Click);
            //
            // AppSettingsForm
            //
            this->ClientSize = System::Drawing::Size(217, 166);
            this->Controls->Add(this->reloadButton);
            this->Controls->Add(this->statusDisplay);
            this->Controls->Add(this->resetButton);
            this->Controls->Add(this->backColorButton);
            this->Name = "AppSettingsForm";
            this->Text = "App Settings";
            this->FormClosing += gcnew
                System::Windows::Forms::FormClosingEventHandler
                (this,&AppSettingsForm::AppSettingsForm_FormClosing);
            this->Load += gcnew System::EventHandler(this,
                &AppSettingsForm::AppSettingsForm_Load);
            this->ResumeLayout(false);
            this->PerformLayout();

        }

#pragma endregion

    private:
        System::Windows::Forms::ColorDialog^ colorDialog;

        System::Windows::Forms::Button^ backColorButton;

        System::Windows::Forms::Button^ resetButton;

        System::Windows::Forms::TextBox^ statusDisplay;

        System::Windows::Forms::Button^ reloadButton;



        FormSettings ^ formSettings;

    public:
        AppSettingsForm()
        {
            formSettings = gcnew FormSettings;
            InitializeComponent();
        }

    private:
        void AppSettingsForm_Load(Object^ sender, EventArgs^ e)
        {
            //Associate settings property event handlers.
            formSettings->SettingChanging += gcnew SettingChangingEventHandler(
                this, &AppSettingsForm::FormSettings_SettingChanging);
            formSettings->SettingsSaving += gcnew SettingsSavingEventHandler(
                this,&AppSettingsForm::FormSettings_SettingsSaving);

            //Data bind settings properties with straightforward associations.
            Binding^ backColorBinding = gcnew Binding("BackColor", 
                formSettings, "FormBackColor", true, 
                DataSourceUpdateMode::OnPropertyChanged);
            this->DataBindings->Add(backColorBinding);
            Binding^ sizeBinding = gcnew Binding("Size", formSettings,
                "FormSize", true, DataSourceUpdateMode::OnPropertyChanged);
            this->DataBindings->Add(sizeBinding);
            Binding^ locationBinding = gcnew Binding("Location", formSettings,
                "FormLocation", true, DataSourceUpdateMode::OnPropertyChanged);
            this->DataBindings->Add(locationBinding);

            //For more complex associations, manually assign associations.
            String^ savedText = formSettings->FormText;
            //Since there is no default value for FormText.
            if (savedText != nullptr)
            {
                this->Text = savedText;
            }
        }

    private:
        void AppSettingsForm_FormClosing(Object^ sender,
            FormClosingEventArgs^ e)
        {
            //Synchronize manual associations first.
            formSettings->FormText = this->Text + '.';
            formSettings->Save();
        }

    private:
        void BackColorButton_Click(Object^ sender, EventArgs^ e)
        {
            if (::DialogResult::OK == colorDialog->ShowDialog())
            {
                Color color = colorDialog->Color;
                this->BackColor = color;
            }
        }

    private:
        void ResetButton_Click(Object^ sender, EventArgs^ e)
        {
            formSettings->Reset();
            this->BackColor = SystemColors::Control;
        }

    private:
        void ReloadButton_Click(Object^ sender, EventArgs^ e)
        {
            formSettings->Reload();
        }

    private:
        void FormSettings_SettingChanging(Object^ sender,
            SettingChangingEventArgs^ e)
        {
            statusDisplay->Text = e->SettingName + ": " + e->NewValue;
        }

    private:
        void FormSettings_SettingsSaving(Object^ sender,
            CancelEventArgs^ e)
        {
            //Should check for settings changes first.
            ::DialogResult^ dialogResult = MessageBox::Show(
                "Save current values for application settings?",
                "Save Settings", MessageBoxButtons::YesNo);
            if (::DialogResult::No == dialogResult)
            {
                e->Cancel = true;
            }
        }
    };
   partial class Form1 : Form
   {
       private FormSettings frmSettings1 = new FormSettings();

       public Form1()
       {
           InitializeComponent();
       }

       private void Form1_Load(object sender, EventArgs e)
       {
           this.FormClosing += new FormClosingEventHandler(Form1_FormClosing);

           //Associate settings property event handlers.
           frmSettings1.SettingChanging += new SettingChangingEventHandler(
                                               frmSettings1_SettingChanging);
           frmSettings1.SettingsSaving += new SettingsSavingEventHandler(
                                               frmSettings1_SettingsSaving);

           //Data bind settings properties with straightforward associations.
           Binding bndBackColor = new Binding("BackColor", frmSettings1, 
               "FormBackColor", true, DataSourceUpdateMode.OnPropertyChanged);
           this.DataBindings.Add(bndBackColor);
           Binding bndLocation = new Binding("Location", frmSettings1, 
               "FormLocation", true, DataSourceUpdateMode.OnPropertyChanged);
           this.DataBindings.Add(bndLocation);

           // Assign Size property, since databinding to Size doesn't work well.
            this.Size = frmSettings1.FormSize;

           //For more complex associations, manually assign associations.
           String savedText = frmSettings1.FormText;
           //Since there is no default value for FormText.
           if (savedText != null)
               this.Text = savedText;
       }

       private void Form1_FormClosing(object sender, FormClosingEventArgs e)
       {
           //Synchronize manual associations first.
           frmSettings1.FormText = this.Text + '.';
           frmSettings1.FormSize = this.Size;
           frmSettings1.Save();
       }

       private void btnBackColor_Click(object sender, EventArgs e)
       {
           if (DialogResult.OK == colorDialog1.ShowDialog())
           {
               Color c = colorDialog1.Color;
               this.BackColor = c;
           }
       }

       private void btnReset_Click(object sender, EventArgs e)
       {
           frmSettings1.Reset();
           this.BackColor = SystemColors.Control;
       }

       private void btnReload_Click(object sender, EventArgs e)
       {
           frmSettings1.Reload();
       }

       void frmSettings1_SettingChanging(object sender, SettingChangingEventArgs e)
       {
           tbStatus.Text = e.SettingName + ": " + e.NewValue;
       }

       void frmSettings1_SettingsSaving(object sender, CancelEventArgs e)
       {
           //Should check for settings changes first.
           DialogResult dr = MessageBox.Show(
                           "Save current values for application settings?",
                           "Save Settings", MessageBoxButtons.YesNo);
           if (DialogResult.No == dr)
           {
               e.Cancel = true;
           }
       }
   }

   //Application settings wrapper class
   sealed class FormSettings : ApplicationSettingsBase
   {
       [UserScopedSettingAttribute()]
       public String FormText
       {
           get { return (String)this["FormText"]; }
           set { this["FormText"] = value; }
       }

       [UserScopedSettingAttribute()]
       [DefaultSettingValueAttribute("0, 0")]
       public Point FormLocation
       {
           get { return (Point)(this["FormLocation"]); }
           set { this["FormLocation"] = value; }
       }

       [UserScopedSettingAttribute()]
       [DefaultSettingValueAttribute("225, 200")]
       public Size FormSize
       {
           get { return (Size)this["FormSize"]; }
           set { this["FormSize"] = value; }
       }

       [UserScopedSettingAttribute()]
       [DefaultSettingValueAttribute("LightGray")]
       public Color FormBackColor
       {
           get { return (Color)this["FormBackColor"]; }
           set { this["FormBackColor"] = value; }
       }
   }

Imports System.Configuration
Imports System.ComponentModel

Public Class Form1

    Private WithEvents frmSettings1 As New FormSettings

    Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) _
            Handles MyBase.Load
        'Settings property event handlers are associated through WithEvents 
        '  and Handles combination.

        'Data bind settings properties with straightforward associations.
        Dim bndBackColor As New Binding("BackColor", frmSettings1, "FormBackColor", _
                True, DataSourceUpdateMode.OnPropertyChanged)
        Me.DataBindings.Add(bndBackColor)
        Dim bndLocation As New Binding("Location", frmSettings1, "FormLocation", _
                True, DataSourceUpdateMode.OnPropertyChanged)
        Me.DataBindings.Add(bndLocation)

        ' Assign Size property, since databinding to Size doesn't work well.
        Me.Size = frmSettings1.FormSize

        'For more complex associations, manually assign associations.
        Dim savedText As String = frmSettings1.FormText
        'Since there is no default value for FormText.
        If (savedText IsNot Nothing) Then
            Me.Text = savedText
        End If
    End Sub

    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

    Private Sub btnBackColor_Click(ByVal sender As Object, ByVal e As EventArgs) _
            Handles btnBackColor.Click
        If System.Windows.Forms.DialogResult.OK = colorDialog1.ShowDialog() Then
            Dim c As Color = colorDialog1.Color
            Me.BackColor = c
        End If
    End Sub

    Private Sub btnReset_Click(ByVal sender As Object, ByVal e As EventArgs) _
            Handles btnReset.Click
        frmSettings1.Reset()
        Me.BackColor = SystemColors.Control
    End Sub

    Private Sub btnReload_Click(ByVal sender As Object, ByVal e As EventArgs) _
            Handles btnReload.Click
        frmSettings1.Reload()
    End Sub

    Private Sub frmSettings1_SettingChanging(ByVal sender As Object, ByVal e As _
            SettingChangingEventArgs) Handles frmSettings1.SettingChanging
        tbStatus.Text = e.SettingName & ": " & e.NewValue.ToString
    End Sub

    Private Sub frmSettings1_SettingsSaving(ByVal sender As Object, ByVal e As _
            CancelEventArgs) Handles frmSettings1.SettingsSaving
        'Should check for settings changes first.
        Dim dr As DialogResult = MessageBox.Show( _
            "Save current values for application settings?", "Save Settings", _
            MessageBoxButtons.YesNo)
        If (System.Windows.Forms.DialogResult.No = dr) Then
            e.Cancel = True
        End If
    End Sub
End Class

'Application settings wrapper class. This class defines the settings we intend to use in our application.
NotInheritable Class FormSettings
    Inherits ApplicationSettingsBase

    <UserScopedSettingAttribute()> _
    Public Property FormText() As String
        Get
            Return CStr(Me("FormText"))
        End Get
        Set(ByVal value As String)
            Me("FormText") = value
        End Set
    End Property

    <UserScopedSettingAttribute(), DefaultSettingValueAttribute("0, 0")> _
    Public Property FormLocation() As Point
        Get
            Return CType(Me("FormLocation"), Point)
        End Get
        Set(ByVal value As Point)
            Me("FormLocation") = value
        End Set
    End Property

    <UserScopedSettingAttribute(), DefaultSettingValueAttribute("225, 200")> _
    Public Property FormSize() As Size
        Get
            Return CType(Me("FormSize"), Size)
        End Get
        Set(ByVal value As Size)
            Me("FormSize") = value
        End Set
    End Property

    <UserScopedSettingAttribute(), DefaultSettingValueAttribute("LightGray")> _
    Public Property FormBackColor() As Color
        Get
            Return CType(Me("FormBackColor"), Color)
        End Get
        Set(ByVal value As Color)
            Me("FormBackColor") = value
        End Set
    End Property
End Class

備註

ApplicationSettingsBase 會將下列功能加入至 Web 應用程式所使用的 SettingsBase 類別:ApplicationSettingsBase adds the following functionality to the SettingsBase class, which is used by Web-based applications:

  • 能夠偵測衍生的設定包裝函式類別上的屬性。The ability to detect attributes on a derived, settings wrapper class. ApplicationSettingsBase 支援用於包裝函式類別屬性的宣告式模型,如稍後所述。ApplicationSettingsBase supports the declarative model used for wrapper class properties, as described later.

  • 較高層級的 SaveReload 方法。Higher-level Save and Reload methods.

  • 您可以處理的其他驗證事件,以確保個別設定的正確性。Additional validation events that you can handle to ensure the correctness of individual settings.

在應用程式設定架構中,若要存取一組設定屬性,您必須從 ApplicationSettingsBase衍生具體的包裝函式類別。In the application settings architecture, to access a group of settings properties you need to derive a concrete wrapper class from ApplicationSettingsBase. 包裝函式類別會以下列方式自訂 ApplicationSettingsBaseThe wrapper class customizes ApplicationSettingsBase in the following ways:

  • 針對要存取的每個設定屬性,會將對應的強型別公用屬性新增至包裝函式類別。For every settings property to be accessed, a corresponding strongly typed public property is added to the wrapper class. 這個屬性具有讀取/寫入應用程式設定的 getset 存取子,但只有唯讀設定的 get 存取子。This property has get and set accessors for read/write application settings, but only a get accessor for read-only settings.

  • 適當屬性必須套用至包裝函式類別的公用屬性,以指出 settings 屬性的特性,例如設定的範圍(應用程式或使用者),設定是否應支援漫遊,預設值為設定、要使用的設定提供者等。Appropriated attributes must be applied to the wrapper class's public properties to indicate characteristics of the settings property, such as the setting's scope (application or user), whether the setting should support roaming, the default value for the setting, the settings provider to be used, and so on. 每個屬性都必須使用 ApplicationScopedSettingAttributeUserScopedSettingAttribute來指定其範圍。Each property is required to specify its scope, using either ApplicationScopedSettingAttribute or UserScopedSettingAttribute. 如果使用預設的 LocalFileSettingsProvider,應用程式範圍的設定會是唯讀的。Application-scoped settings are read-only if the default LocalFileSettingsProvider is used.

ApplicationSettingsBase 類別會使用反映,在執行時間偵測這些屬性。The ApplicationSettingsBase class uses reflection to detect these attributes at run time. 此資訊大多會傳遞給設定提供者層,負責儲存、保存格式等等。Most of this information gets passed to the settings provider layer, which is responsible for storage, persistence format, and so on.

當應用程式有多個設定包裝函式類別時,每個類別都會定義一個設定群組When an application has multiple settings wrapper classes, each class defines a settings group. 每個群組都具有下列特性:Each group has the following characteristics:

  • 群組可以包含任何數目或類型的屬性設定。A group can contain any number or type of property settings.

  • 如果未明確設定組名,並以 SettingsGroupNameAttribute裝飾包裝函式類別,則會自動產生名稱。If the group name is not explicitly set by the decorating the wrapper class with a SettingsGroupNameAttribute, then a name is automatically generated.

根據預設,所有以用戶端為基礎的應用程式都會使用 LocalFileSettingsProvider 來提供儲存體。By default, all client-based applications use the LocalFileSettingsProvider to provide storage. 如果需要替代設定提供者,則必須使用對應的 SettingsProviderAttribute裝飾包裝函式類別或屬性。If an alternate settings provider is desired, then the wrapper class or property must be decorated with a corresponding SettingsProviderAttribute.

如需使用應用程式設定的詳細資訊,請參閱Windows Forms 的應用程式設定For more information about using application settings, see Application Settings for Windows Forms.

建構函式

ApplicationSettingsBase()

ApplicationSettingsBase 類別的執行個體初始化成其預設狀態。Initializes an instance of the ApplicationSettingsBase class to its default state.

ApplicationSettingsBase(IComponent)

使用提供的擁有者元件,初始化 ApplicationSettingsBase 類別的執行個體。Initializes an instance of the ApplicationSettingsBase class using the supplied owner component.

ApplicationSettingsBase(IComponent, String)

使用提供的擁有者元件和設定索引鍵,初始化 ApplicationSettingsBase 類別的執行個體。Initializes an instance of the ApplicationSettingsBase class using the supplied owner component and settings key.

ApplicationSettingsBase(String)

使用提供的設定索引鍵,初始化 ApplicationSettingsBase 類別的執行個體。Initializes an instance of the ApplicationSettingsBase class using the supplied settings key.

屬性

Context

取得與設定群組相關的應用程式設定內容。Gets the application settings context associated with the settings group.

IsSynchronized

取得值,指出對物件的存取是否為同步的 (安全執行緒)。Gets a value indicating whether access to the object is synchronized (thread safe).

(繼承來源 SettingsBase)
Item[String]

取得或設定指定應用程式設定屬性的值。Gets or sets the value of the specified application settings property.

Properties

取得包裝函式中設定屬性的集合。Gets the collection of settings properties in the wrapper.

PropertyValues

取得屬性值的集合。Gets a collection of property values.

Providers

取得包裝函式使用之應用程式設定提供者的集合。Gets the collection of application settings providers used by the wrapper.

SettingsKey

取得或設定應用程式設定群組的設定索引鍵。Gets or sets the settings key for the application settings group.

方法

Equals(Object)

判斷指定的物件是否等於目前的物件。Determines whether the specified object is equal to the current object.

(繼承來源 Object)
GetHashCode()

做為預設雜湊函式。Serves as the default hash function.

(繼承來源 Object)
GetPreviousVersion(String)

傳回同一應用程式之前一版本的具名設定屬性值。Returns the value of the named settings property for the previous version of the same application.

GetType()

取得目前執行個體的 TypeGets the Type of the current instance.

(繼承來源 Object)
Initialize(SettingsContext, SettingsPropertyCollection, SettingsProviderCollection)

初始化 SettingsBase 物件所用的內部屬性。Initializes internal properties used by SettingsBase object.

(繼承來源 SettingsBase)
MemberwiseClone()

建立目前 Object 的淺層複製。Creates a shallow copy of the current Object.

(繼承來源 Object)
OnPropertyChanged(Object, PropertyChangedEventArgs)

引發 PropertyChanged 事件。Raises the PropertyChanged event.

OnSettingChanging(Object, SettingChangingEventArgs)

引發 SettingChanging 事件。Raises the SettingChanging event.

OnSettingsLoaded(Object, SettingsLoadedEventArgs)

引發 SettingsLoaded 事件。Raises the SettingsLoaded event.

OnSettingsSaving(Object, CancelEventArgs)

引發 SettingsSaving 事件。Raises the SettingsSaving event.

Reload()

重新整理持續性儲存體 (Persistent Storage) 的應用程式設定屬性值。Refreshes the application settings property values from persistent storage.

Reset()

將保存的應用程式設定值還原至其對應的預設屬性。Restores the persisted application settings values to their corresponding default properties.

Save()

儲存應用程式設定屬性的目前值。Stores the current values of the application settings properties.

ToString()

傳回代表目前物件的字串。Returns a string that represents the current object.

(繼承來源 Object)
Upgrade()

更新應用程式設定,以反映應用程式的最近安裝。Updates application settings to reflect a more recent installation of the application.

事件

PropertyChanged

發生於應用程式設定屬性值變更之後。Occurs after the value of an application settings property is changed.

SettingChanging

發生於應用程式設定屬性值變更之前。Occurs before the value of an application settings property is changed.

SettingsLoaded

發生於從儲存區擷取應用程式設定之後。Occurs after the application settings are retrieved from storage.

SettingsSaving

發生於值儲存至資料存放區之前。Occurs before values are saved to the data store.

適用於

另請參閱