ApplicationSettingsBase.SettingsKey Właściwość

Definicja

Przestrzeń nazw:

System.Configuration

Zestaw:

System.Configuration.ConfigurationManager.dll

Pakiet:

System.Configuration.ConfigurationManager v8.0.0

Źródło:

ApplicationSettingsBase.cs

Pobiera lub ustawia klucz ustawień dla grupy ustawień aplikacji.

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

Wartość właściwości

String

Element String zawierający klucz ustawień dla bieżącej grupy ustawień.

Atrybuty

BrowsableAttribute

Uwagi

Właściwość SettingsKey jest udostępniana w celu włączenia kodu klienta, a w szczególności dostawcy ustawień, do uściślania między wieloma wystąpieniami tej samej klasy ustawień aplikacji.

Chyba że klasa otoki ustawień została zaprojektowana przy użyciu wzorca pojedynczego, w jednej aplikacji może istnieć wiele wystąpień tej samej klasy ustawień aplikacji. Wartość SettingsKey powinna być ustawiana zgodnie z sposobem udostępniania wartości właściwości.

• Jeśli właściwości ustawień otoki mają być współużytkowane we wszystkich wystąpieniach otoki w tej samej aplikacji, SettingsKey powinna mieć tę samą wartość we wszystkich wystąpieniach. Jest to domyślne zachowanie ApplicationSettingsBase klasy.

• Jeśli właściwości ustawień otoki mają być na wystąpienie, SettingsKey powinna mieć unikatową wartość dla każdego wystąpienia. Wersja ApplicationSettingsBase(String) konstruktora umożliwia zainicjowanie SettingsKey unikatowego ciągu.

Natomiast właściwość udostępnia wskazówki dla dostawcy ustawień, Context aby umożliwić jej utrwalanie wartości w wydajny i uporządkowany sposób.

Klasa SettingChangingEventArgs zawiera podobną SettingKey właściwość, która pomaga zidentyfikować źródło SettingChanging zdarzenia.

Zobacz też

• Context
• SettingChangingEventArgs