ApplicationSettingsBase 建構函式
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
初始化該 ApplicationSettingsBase 類別的實例。
多載
| 名稱 | Description |
|---|---|
| ApplicationSettingsBase() |
將類別的實例 ApplicationSettingsBase 初始化為預設狀態。 |
| ApplicationSettingsBase(IComponent) |
使用所提供的擁有者元件初始化該 ApplicationSettingsBase 類別的實例。 |
| ApplicationSettingsBase(String) |
使用提供的設定鍵初始化類別實例 ApplicationSettingsBase 。 |
| ApplicationSettingsBase(IComponent, String) |
使用提供的擁有者元件與設定鍵初始化類別實例 ApplicationSettingsBase 。 |
ApplicationSettingsBase()
將類別的實例 ApplicationSettingsBase 初始化為預設狀態。
protected:
ApplicationSettingsBase();protected ApplicationSettingsBase();Protected Sub New ()備註
無參數建構器設計時，假設目前的設定包裝類別（源自 ApplicationSettingsBase）沒有相關元件。
當建立包裝類別實例時，繼承的程式碼會自動執行以下動作：
反思這堂課。
對於包裝器上標記為
[UserScopedSettingAttribute]或[ApplicationScopedSettingAttribute]的每個屬性，都會建立對應 SettingsProperty 屬性。每個 SettingsProperty 屬性的部分屬性是基於包裝器屬性中可選擇存在的屬性，例如預設值或設定提供者。
其他屬性則直接放入屬性袋，即 Attributes 類別的 SettingsProperty 屬性。
所有SettingsProperty物件都被加入由SettingsPropertyCollectionProperties類別屬性所表示的 。ApplicationSettingsBase 這個集合接著會傳遞給方法。Initialize
如前述步驟3所示， ApplicationSettingsBase 原生處理多種屬性，具體如下： SettingsProviderAttribute、、 DefaultSettingValueAttribute及 SettingsSerializeAsAttribute。 其他所有設定屬性都會直接傳遞給適當的底層提供者。
另請參閱
- SettingsProperty
- SettingsPropertyCollection
- Initialize(SettingsContext, SettingsPropertyCollection, SettingsProviderCollection)
適用於
ApplicationSettingsBase(IComponent)
使用所提供的擁有者元件初始化該 ApplicationSettingsBase 類別的實例。
protected:
ApplicationSettingsBase(System::ComponentModel::IComponent ^ owner);protected ApplicationSettingsBase(System.ComponentModel.IComponent owner);new System.Configuration.ApplicationSettingsBase : System.ComponentModel.IComponent -> System.Configuration.ApplicationSettingsBaseProtected Sub New (owner As IComponent)參數
- owner
- IComponent
這個元件會作為應用程式設定物件的擁有者。
例外狀況
owner 是 null。
備註
此建構子與 ApplicationSettingsBase(IComponent, String) 使用呼叫時的建構子完全等價：
ApplicationSettingsBase(owner, String.Empty)
關於在包裝類別實例化時如何使用反射的資訊，請參見預設 ApplicationSettingsBase() 建構子。
另請參閱
適用於
ApplicationSettingsBase(String)
使用提供的設定鍵初始化類別實例 ApplicationSettingsBase 。
protected:
ApplicationSettingsBase(System::String ^ settingsKey);protected ApplicationSettingsBase(string settingsKey);new System.Configuration.ApplicationSettingsBase : string -> System.Configuration.ApplicationSettingsBaseProtected Sub New (settingsKey As String)參數
備註
此建構子將屬性初始 SettingsKey 化為參數值 settingsKey 。 此特性有助於辨識同一應用域中不同設定包裝類別的實例。
關於在包裝類別實例化時如何使用反射的資訊，請參見預設 ApplicationSettingsBase() 建構子。
另請參閱
適用於
ApplicationSettingsBase(IComponent, String)
使用提供的擁有者元件與設定鍵初始化類別實例 ApplicationSettingsBase 。
protected:
ApplicationSettingsBase(System::ComponentModel::IComponent ^ owner, System::String ^ settingsKey);protected ApplicationSettingsBase(System.ComponentModel.IComponent owner, string settingsKey);new System.Configuration.ApplicationSettingsBase : System.ComponentModel.IComponent * string -> System.Configuration.ApplicationSettingsBaseProtected Sub New (owner As IComponent, settingsKey As String)參數
- owner
- IComponent
這個元件會作為應用程式設定物件的擁有者。
例外狀況
owner 是 null。
備註
IComponent由owner參數指定的物件會作為目前應用程式 settings 類別實例的擁有者。 在初始化由 ApplicationSettingsBase衍生出的設定包裝類別時，會查詢擁有者的網站是否有 ISettingsProviderService。 如果有包裝類別，則優先使用該設定，優先於提供包裝類別所有屬性的原生設定，依照 SettingsProviderAttribute。
此建構子將屬性初始 SettingsKey 化為參數值 settingsKey 。 此特性有助於辨識同一應用域中包裝類別的不同實例。
關於在包裝類別實例化時如何使用反射的資訊，請參見預設 ApplicationSettingsBase() 建構子。
