LocalFileSettingsProvider 類別

  • 參考

定義

命名空間:
System.Configuration
組件:
System.Configuration.ConfigurationManager.dll
組件:
System.dll

提供應用程式設定類別的持續性 (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)

嘗試從舊版的同一應用程式中移轉先前的使用者範圍中的設定。

適用於

另請參閱