LocalFileSettingsProvider 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
提供應用程式設定類別的持久性。
public ref class LocalFileSettingsProvider : System::Configuration::SettingsProvider, System::Configuration::IApplicationSettingsProviderpublic class LocalFileSettingsProvider : System.Configuration.SettingsProvider, System.Configuration.IApplicationSettingsProvidertype LocalFileSettingsProvider = class
inherit SettingsProvider
interface IApplicationSettingsProviderPublic Class LocalFileSettingsProvider
Inherits SettingsProvider
Implements IApplicationSettingsProvider- 繼承
- 實作
備註
設定提供者定義了一種儲存應用程式設定架構中使用的組態資料的機制。 .NET Framework 包含單一預設設定提供者 LocalFileSettingsProvider，將配置資料儲存到本地檔案系統。 應用程式設定屬性或屬性群組透過 SettingsProviderAttribute.
通常，用戶端程式不會明確存取此類別;相反地，應用程式設定架構會在需要服務時自動呼叫相應的設定提供者。 例如，許多成員 ApplicationSettingsBase 會將工作委派給相關環境提供者。
LocalFileSettingsProvider 將設定持久化為副檔名為 .config的設定檔。 設定檔的內容以 XML 文件形式結構化。 根據設定是應用層級還是使用者層級的範圍，組態資料分別以元素形式儲存在一個 <applicationSettings> 或一個 <userSettings> 區段群組中。 這些截面群分別以對應 AppSettingsSection 的或 ClientSettingsSection表示。 每個區段物件由一個配置區段處理器擁有並管理，該處理程序是一個型別 IConfigurationSectionHandler為 的物件。
應用程式範圍設定與預設使用者範圍設定會儲存在一個名為 application.exe.config的檔案中，該檔案與執行檔建立在同一目錄中。 應用程式設定為唯讀。 特定的使用者資料會儲存在名為 user.config的檔案中，儲存在使用者的主目錄下。 若啟用漫遊設定檔，使用者設定檔可能存在兩個版本。 在這種情況下，漫遊版本的條目會優先於本地使用者設定檔中重複的條目。
欲了解更多應用程式設定資訊，請參閱 Windows Forms
建構函式
| 名稱 | Description |
|---|---|
| LocalFileSettingsProvider() |
初始化 LocalFileSettingsProvider 類別的新執行個體。 |
屬性
| 名稱 | Description |
|---|---|
| ApplicationName |
取得或設定目前執行中的應用程式名稱。 |
| Description |
取得簡短且易記的描述，適合顯示在系統管理工具或其他使用者介面中。 (繼承來源 ProviderBase) |
| Name |
取得組態期間用來參考提供者的易記名稱。 (繼承來源 ProviderBase) |
方法
| 名稱 | Description |
|---|---|
| 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) |
嘗試從同一應用程式的舊版本遷移先前的使用者範圍設定。 |
