ApplicationSettingsBase.SettingsKey Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define a chave de definições para o grupo de definições da aplicação.
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, setPublic Property SettingsKey As StringValor de Propriedade
A String contendo a chave de definições para o grupo de definições atual.
- Atributos
Observações
A SettingsKey propriedade é fornecida para permitir que o código cliente, e em particular o fornecedor de definições, desambigue entre múltiplas instâncias da mesma classe de definições de aplicação.
A menos que a classe de wrapper de definições seja desenhada usando o padrão singleton, podem existir múltiplas instâncias da mesma classe de definições de aplicação numa única aplicação. O valor de SettingsKey deve ser definido de acordo com a forma como se pretende partilhar os valores das propriedades.
Se as propriedades de definições do wrapper forem destinadas a ser partilhadas entre todas as instâncias do wrapper na mesma aplicação, então SettingsKey devem ter o mesmo valor em todas as instâncias. Este é o comportamento padrão da ApplicationSettingsBase classe.
Se as propriedades de definição do wrapper forem destinadas a ser por instância, então SettingsKey devem ter um valor único para cada instância. A ApplicationSettingsBase(String) versão do construtor permite-lhe inicializar SettingsKey para uma cadeia única.
Em contraste, a Context propriedade fornece dicas ao fornecedor de definições para permitir que os valores persistam de forma eficiente e ordenada.
A SettingChangingEventArgs classe contém uma propriedade semelhante SettingKey que ajuda a identificar a origem do SettingChanging evento.