ApplicationSettingsBase.SettingsKey Свойство

Определение

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

System.Configuration

Сборка:

System.Configuration.ConfigurationManager.dll

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

ApplicationSettingsBase.cs

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

public:
 property System::String ^ SettingsKey { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.Browsable(false)]
public string SettingsKey { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.SettingsKey : string with get, set

Public Property SettingsKey As String

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

String

Содержит String ключ параметров для текущей группы параметров.

Атрибуты

BrowsableAttribute

Комментарии

Свойство SettingsKey предоставляется для включения клиентского кода и, в частности, поставщика параметров для диамбигуации между несколькими экземплярами одного класса параметров приложения.

Если класс оболочки параметров не разработан с помощью единого шаблона, в одном приложении может быть несколько экземпляров одного класса параметров приложения. Значение SettingsKey должно быть задано в соответствии с способом общего доступа к значениям свойств.

• Если свойства параметров оболочки предназначены для общего доступа ко всем экземплярам оболочки в одном приложении, SettingsKey то должно иметь одинаковое значение во всех экземплярах. Это поведение ApplicationSettingsBase класса по умолчанию.

• Если свойства параметров оболочки предназначены для каждого экземпляра, SettingsKey необходимо иметь уникальное значение для каждого экземпляра. Версия ApplicationSettingsBase(String) конструктора позволяет инициализировать SettingsKey уникальную строку.

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

Класс SettingChangingEventArgs содержит аналогичное SettingKey свойство, которое помогает определить источник SettingChanging события.

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

• Context
• SettingChangingEventArgs