Compartilhar via

Atributos de Configurações de Aplicativo

  • Artigo

A arquitetura de Configurações de Aplicativo fornece muitos atributos que podem ser aplicados à classe wrapper de configurações de aplicativos ou às suas propriedades individuais. Esses atributos são examinados em tempo de execução pela infraestrutura de configurações do aplicativo, geralmente especificamente o provedor de configurações, a fim de adaptar seu funcionamento às necessidades declaradas do wrapper personalizado.

A tabela a seguir lista os atributos que podem ser aplicados à classe wrapper de configurações do aplicativo, às propriedades individuais dessa classe ou a ambos. Por definição, apenas um único atributo de escopo,UserScopedSettingAttribute ou ApplicationScopedSettingAttribute, deve ser aplicado a cada propriedade de configurações.

Nota

Um provedor de configurações personalizado, derivado da classe SettingsProvider, é necessário apenas para reconhecer os três atributos a seguir: ApplicationScopedSettingAttribute, UserScopedSettingAttribute, e DefaultSettingValueAttribute.

Atributo Alvo Descrição
SettingsProviderAttribute Ambos Especifica o nome curto do provedor de configurações a ser usado para persistência.

Se esse atributo não for fornecido, o provedor padrão, LocalFileSettingsProvider, será assumido.
UserScopedSettingAttribute Ambos Defina uma propriedade como uma configuração de aplicativo com escopo de usuário.
ApplicationScopedSettingAttribute Ambos Define uma propriedade como uma configuração de escopo de aplicativo.
DefaultSettingValueAttribute Propriedade Especifica uma cadeia de caracteres que pode ser desserializada pelo provedor no valor padrão codificado para essa propriedade.

O LocalFileSettingsProvider não requer esse atributo e substituirá qualquer valor fornecido por esse atributo se houver um valor já persistente.
SettingsDescriptionAttribute Propriedade Fornece o teste descritivo para uma configuração individual, usada principalmente por ferramentas de tempo de execução e tempo de design.
SettingsGroupNameAttribute Classe Fornece um nome explícito para um grupo de configurações. Se esse atributo estiver ausente, ApplicationSettingsBase usará o nome da classe wrapper.
SettingsGroupDescriptionAttribute Classe Fornece o teste descritivo para um grupo de configurações, usado principalmente por ferramentas de tempo de execução e tempo de design.
SettingsManageabilityAttribute Ambos Especifica zero ou mais serviços de gerenciamento que devem ser fornecidos ao grupo de configurações ou à propriedade. Os serviços disponíveis são descritos pela enumeração SettingsManageability.
SpecialSettingAttribute Propriedade Indica que uma configuração pertence a uma categoria especial predefinida, como uma cadeia de conexão, que sugere processamento especial pelo provedor de configurações. As categorias predefinidas para esse atributo são definidas pela enumeração SpecialSetting.
SettingsSerializeAsAttribute Ambos Especifica um mecanismo de serialização preferencial para um grupo de configurações ou propriedade. Os mecanismos de serialização disponíveis são definidos pela enumeração SettingsSerializeAs.
NoSettingsVersionUpgradeAttribute Propriedade Especifica que um provedor de configurações deve desabilitar todas as funcionalidades de atualização do aplicativo para a propriedade marcada.

Class indica que o atributo pode ser aplicado somente a uma classe wrapper de configurações de aplicativo. Property indica que o atributo pode ser aplicado apenas às propriedades de configurações. Ambos os indica que o atributo pode ser aplicado em qualquer nível.

Consulte também