LocalFileSettingsProvider 類別

定義

命名空間:

System.Configuration

組件:

System.Configuration.ConfigurationManager.dll

套件:

System.Configuration.ConfigurationManager v8.0.0

來源:

LocalFileSettingsProvider.cs

提供應用程式設定類別的持續性 (Persistence)。

public ref class LocalFileSettingsProvider : System::Configuration::SettingsProvider, System::Configuration::IApplicationSettingsProvider

public class LocalFileSettingsProvider : System.Configuration.SettingsProvider, System.Configuration.IApplicationSettingsProvider

type LocalFileSettingsProvider = class
    inherit SettingsProvider
    interface IApplicationSettingsProvider

Public Class LocalFileSettingsProvider
Inherits SettingsProvider
Implements IApplicationSettingsProvider

繼承

Object

ProviderBase

SettingsProvider

LocalFileSettingsProvider

實作

IApplicationSettingsProvider

備註

設定提供者會定義機制來儲存應用程式設定架構中使用的組態數據。 .NET Framework 包含單一預設設定提供者，LocalFileSettingsProvider其會將組態數據儲存至本機文件系統。 應用程式設定屬性或屬性群組會透過使用 SettingsProviderAttribute，與特定設定提供者相關聯。

一般而言，用戶端程式不會明確存取這個類別;相反地，應用程式設定架構會在需要其服務時自動叫用適當的設定提供者。 例如，許多成員 ApplicationSettingsBase 都會將其工作委派給相關聯的設定提供者。

LocalFileSettingsProvider 將設定保存到擴展名 .config為的組態檔。 組態檔的內容會結構化為 XML 檔。 根據設定的範圍是應用層級或用戶層級，設定數據會分別儲存為 或 <userSettings> 區段群組內的<applicationSettings>元素。 每個區段群組分別以對應的 AppSettingsSection 或 ClientSettingsSection表示。 每個區段物件都是由組態區段處理程式所擁有和管理，這是類型的 IConfigurationSectionHandler物件。

應用程式範圍的設定和預設使用者範圍設定會儲存在名為 application.exe.config的檔案中，該檔案會建立在與可執行檔相同的目錄中。 應用程式組態設定是唯讀的。 特定使用者資料會儲存在名為 user.config的檔案中，儲存在使用者的主目錄下。 如果已啟用漫遊配置檔，則可能有兩個版本的用戶組態檔。 在這種情況下，漫遊版本中的專案優先於本機用戶組態檔中的重複專案。

如需應用程式設定的詳細資訊，請參閱 Windows Forms的應用程式設定。

建構函式

LocalFileSettingsProvider()

初始化 LocalFileSettingsProvider 類別的新執行個體。

屬性

ApplicationName	取得或設定目前正在執行之應用程式的名稱。
Description	取得簡短、易讀的描述，適合顯示在管理工具或其他使用者介面 (UI) 中。 (繼承來源 ProviderBase)
Name	取得用來在設定期間代表提供者的易記名稱。 (繼承來源 ProviderBase)

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetPreviousVersion(SettingsContext, SettingsProperty)	傳回同一應用程式之前一版本的具名設定屬性值。
GetPropertyValues(SettingsContext, SettingsPropertyCollection)	傳回指定之應用程式執行個體和設定屬性群組的設定屬性值集合。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
Initialize(String, NameValueCollection)	將提供者初始化。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
Reset(SettingsContext)	將與指定應用程式相關聯的所有應用程式設定屬性重設為其預設值。
SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)	設定指定屬性設定群組的值。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
Upgrade(SettingsContext, SettingsPropertyCollection)	嘗試從舊版的同一應用程式中移轉先前的使用者範圍中的設定。

另請參閱

• SettingsProviderAttribute
• ApplicationScopedSettingAttribute
• UserScopedSettingAttribute
• ApplicationSettingsBase
• ClientSettingsSection
• IConfigurationSectionHandler
• 應用程式設定架構