Partilhar via

Atributos de configurações do aplicativo

  • Artigo

A arquitetura Configurações do 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, muitas vezes especificamente pelo 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 ambas. Por definição, apenas um único atributo de escopo — UserScopedSettingAttribute ou ApplicationScopedSettingAttribute — deve ser aplicado a cada propriedade de configurações.

Observação

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

Atributo Público-alvo Descrição
SettingsProviderAttribute Ambos Especifica o nome abreviado 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 Define uma propriedade como uma configuração de aplicativo com escopo de usuário.
ApplicationScopedSettingAttribute Ambos Define-se uma propriedade como uma definição de aplicação com âmbito de aplicação.
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á persistido.
SettingsDescriptionAttribute Propriedade Fornece o teste descritivo para uma definição individual, usado principalmente por ferramentas de execução e 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 gerenciabilidade que devem ser fornecidos ao grupo ou propriedade de configurações. 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 este 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 de aplicativos para a propriedade marcada.

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

Ver também