Udostępnij za pośrednictwem


ApplicationSettingsBase.SettingsKey Właściwość

Definicja

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

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

Atrybuty

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.

Dotyczy

Zobacz też