ApplicationSettingsBase.Item[String] Свойство

Определение

Пространство имен:

System.Configuration

Сборка:

System.Configuration.ConfigurationManager.dll

Пакет:

System.Configuration.ConfigurationManager v8.0.0

Исходный код:

ApplicationSettingsBase.cs

Возвращает или задает значение указанного свойства параметров приложения.

public:
 virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ propertyName); void set(System::String ^ propertyName, System::Object ^ value); };

public override object this[string propertyName] { get; set; }

member this.Item(string) : obj with get, set

Default Public Overrides Property Item(propertyName As String) As Object

Параметры

propertyName

String

String, содержащий имя свойства для доступа.

Значение свойства

Object

Если найден, то значение именованного свойства параметров; в противном случае — null.

Исключения

SettingsPropertyNotFoundException

Нет свойств, связанных с текущей программой-оболочкой, или указанное свойство не может быть найдено.

SettingsPropertyIsReadOnlyException

Предпринята попытка задать свойство, доступное только для чтения.

SettingsPropertyWrongTypeException

Предоставленное значение имеет несовместимый со свойством параметров тип значения во время операции установки.

ConfigurationErrorsException

Не удалось проанализировать файл конфигурации.

Комментарии

Свойство Item[] , также известное как индексатор, обычно используется в классе-оболочке параметров, производном от ApplicationSettingsBase. Item[] привязывает открытое свойство класса-оболочки к соответствующему свойству settings.

Item[] Вызывает несколько событий в зависимости от выполняемой операции:

• При первом извлечении SettingsLoaded свойства возникает событие .

• Если свойство задано, OnSettingChanging вызывается событие . Если обработчик не отменяет событие, устанавливается значение свойства и PropertyChanged вызывается событие .

См. также раздел

• Properties
• IsReadOnly