Atributos de Configurações de Aplicativo
A arquitetura de Configurações de Aplicativo fornece muitos atributos que podem ser aplicados à classe wrapper de configurações de aplicativos ou suas propriedades individuais. Esses atributos são examinados no tempo de execução pela infraestrutura de configurações de aplicativo, geralmente 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 de aplicativo, às propriedades individuais desta classe ou a ambos. Por definição, somente um único atributo de escopo —UserScopedSettingAttribute ou ApplicationScopedSettingAttribute— deve ser aplicado a todas as propriedades de configurações.
Observação
Um provedor de configurações personalizadas, derivado da SettingsProvider classe, só é necessário para reconhecer os três atributos a seguir: ApplicationScopedSettingAttribute, UserScopedSettingAttribute e DefaultSettingValueAttribute.
Atributo | Target (destino) | Descrição |
---|---|---|
SettingsProviderAttribute | Ambos | Especifica o nome curto do provedor configurações a ser usado para persistência. Se esse atributo não for fornecido, o provedor padrão, , LocalFileSettingsProviderserá assumido. |
UserScopedSettingAttribute | Ambos | Define uma propriedade como uma configuração de aplicativo no escopo do usuário. |
ApplicationScopedSettingAttribute | Ambos | Define uma propriedade como uma configuração de aplicativo no escopo do aplicativo. |
DefaultSettingValueAttribute | Propriedade | Especifica uma cadeia de caracteres que pode ser desserializada pelo provedor para o valor padrão embutido em código 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 configuração individual, usada primariamente por ferramentas de tempo de execução e de 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 primariamente por ferramentas de tempo de execução e de tempo de design. |
SettingsManageabilityAttribute | Ambos | Especifica zero ou mais serviços de gerenciabilidade que devem ser fornecidos para o grupo de configurações ou propriedade. Os serviços disponíveis são descritos pela SettingsManageability enumeração. |
SpecialSettingAttribute | Propriedade | Indica que uma configuração pertence a uma categoria especial e predefinida, como uma cadeia de conexão, o que sugere um processamento especial pelo provedor de configurações. As categorias predefinidas para esse atributo são definidas pela SpecialSetting enumeração. |
SettingsSerializeAsAttribute | Ambos | Especifica um mecanismo preferencial de serialização para um grupo de configurações ou propriedade. Os mecanismos de serialização disponíveis são definidos pela SettingsSerializeAs enumeração. |
NoSettingsVersionUpgradeAttribute | Propriedade | Especifica que um provedor de configurações deve desabilitar todas as funcionalidade de atualização de aplicativo para a propriedade marcada. |
Classe indica que o atributo pode ser aplicado somente a uma classe wrapper de configurações de aplicativo. Propriedade indica que o atributo pode ser aplicado somente a propriedades de configurações. Ambos indica que o atributo pode ser aplicado em qualquer nível.
Confira também
.NET Desktop feedback