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. Все остальные атрибуты просто помещаются в контейнер атрибутов AttributesSettingsProperty , свойство класса .

5. Все SettingsProperty объекты добавляются в объект , представленный SettingsPropertyCollection свойством PropertiesApplicationSettingsBase класса . Затем эта коллекция передается в 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