ApplicationSettingsBase 建構函式

定義

命名空間:

System.Configuration

組件:

System.Configuration.ConfigurationManager.dll

套件:

System.Configuration.ConfigurationManager v8.0.0

初始化 ApplicationSettingsBase 類別的執行個體。

多載

ApplicationSettingsBase()	將 ApplicationSettingsBase 類別的執行個體初始化成其預設狀態。
ApplicationSettingsBase(IComponent)	使用提供的擁有者元件，初始化 ApplicationSettingsBase 類別的執行個體。
ApplicationSettingsBase(String)	使用提供的設定索引鍵，初始化 ApplicationSettingsBase 類別的執行個體。
ApplicationSettingsBase(IComponent, String)	使用提供的擁有者元件和設定索引鍵，初始化 ApplicationSettingsBase 類別的執行個體。

ApplicationSettingsBase()

來源:

ApplicationSettingsBase.cs

將 ApplicationSettingsBase 類別的執行個體初始化成其預設狀態。

protected:
 ApplicationSettingsBase();

protected ApplicationSettingsBase ();

Protected Sub New ()

備註

無參數建構函式的設計目的是在假設沒有與目前設定包裝函式類別相關聯的元件下運作，其衍生自 ApplicationSettingsBase。

建立包裝函式類別的實例時，繼承的程式代碼會自動執行下列動作：

1. 反映類別。

2. 針對以 [UserScopedSettingAttribute] 或 [ApplicationScopedSettingAttribute]標記之包裝函式上的每個屬性，會建立對應的 SettingsProperty 。

3. 每個 SettingsProperty 屬性都有一些根據包裝函式屬性選擇性存在的其他屬性來設定，例如預設值或設定提供者。

4. 所有其他屬性只會放入屬性包中，也就是 Attributes 類別的 SettingsProperty 屬性。

5. 所有 SettingsProperty 物件都會新增至 SettingsPropertyCollection 類別的 屬性所 Properties 代表的 ApplicationSettingsBase 。 此集合接著會傳遞至 Initialize 方法。

如先前所述步驟 3 所隱含， ApplicationSettingsBase 原生方式適用於數個屬性屬性，特別是： SettingsProviderAttribute、 DefaultSettingValueAttribute和 SettingsSerializeAsAttribute。 所有其他設定屬性只會傳遞至適當的基礎提供者。

另請參閱

• SettingsProperty
• SettingsPropertyCollection
• Initialize(SettingsContext, SettingsPropertyCollection, SettingsProviderCollection)

ApplicationSettingsBase(IComponent)

來源:

ApplicationSettingsBase.cs

使用提供的擁有者元件，初始化 ApplicationSettingsBase 類別的執行個體。

protected:
 ApplicationSettingsBase(System::ComponentModel::IComponent ^ owner);

protected ApplicationSettingsBase (System.ComponentModel.IComponent owner);

new System.Configuration.ApplicationSettingsBase : System.ComponentModel.IComponent -> System.Configuration.ApplicationSettingsBase

Protected Sub New (owner As IComponent)

參數

owner

IComponent

將做為應用程式設定物件之擁有者的元件。

例外狀況

ArgumentNullException

owner 為 null。

備註

此建構函式與使用呼叫的 ApplicationSettingsBase(IComponent, String) 建構函式完全相等：

ApplicationSettingsBase(owner, String.Empty)

如需包裝函式類別具現化期間如何使用反映的資訊，請參閱預設 ApplicationSettingsBase() 建構函式。

另請參閱

• SettingsProviderAttribute
• Site

ApplicationSettingsBase(String)

來源:

ApplicationSettingsBase.cs

使用提供的設定索引鍵，初始化 ApplicationSettingsBase 類別的執行個體。

protected:
 ApplicationSettingsBase(System::String ^ settingsKey);

protected ApplicationSettingsBase (string settingsKey);

new System.Configuration.ApplicationSettingsBase : string -> System.Configuration.ApplicationSettingsBase

Protected Sub New (settingsKey As String)

參數

settingsKey

String

String，可以唯一識別包裝函式類別的個別執行個體。

備註

這個建構函式會將 SettingsKey 屬性初始化為 參數的值 settingsKey 。 這個屬性在釐清相同應用程式域中設定包裝函式類別的不同實例時很有用。

如需包裝函式類別具現化期間如何使用反映的資訊，請參閱預設 ApplicationSettingsBase() 建構函式。

另請參閱

• SettingsKey

ApplicationSettingsBase(IComponent, String)

來源:

ApplicationSettingsBase.cs

使用提供的擁有者元件和設定索引鍵，初始化 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.ApplicationSettingsBase

Protected Sub New (owner As IComponent, settingsKey As String)

參數

owner

IComponent

將做為應用程式設定物件之擁有者的元件。

settingsKey

String

String，可以唯一識別包裝函式類別的個別執行個體。

例外狀況

ArgumentNullException

owner 為 null。

備註

參數 IComponent 所 owner 指定的物件會作為這個應用程式設定類別之目前實例的擁有者。 在初始化衍生自 ApplicationSettingsBase的設定包裝函式類別期間，會查詢擁有者的月臺。ISettingsProviderService 如果存在，則會針對包裝函式類別的所有屬性使用原生設定提供者，如 所 SettingsProviderAttribute指定。

這個建構函式會將 SettingsKey 屬性初始化為 參數的值 settingsKey 。 這個屬性在釐清相同應用程式域中包裝函式類別的不同實例時很有用。

如需包裝函式類別具現化期間如何使用反映的資訊，請參閱預設 ApplicationSettingsBase() 建構函式。

另請參閱

• ISettingsProviderService
• SettingsProviderAttribute
• SettingsKey