Atributos de Configurações do Aplicativo
A arquitetura de Configurações do Aplicativo fornece muitos atributos que podem ser aplicados tanto à classe envoltório 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, em geral especificamente o provedor de configurações, para adaptar seu funcionamento às necessidades declaradas do envoltório personalizado.
A tabela a seguir lista os atributos que podem ser aplicados à classe envoltório de configurações do aplicativo, às propriedades individuais desta classe ou ambos. Por definição, somente um único atributo de escopo — UserScopedSettingAttribute ou ApplicationScopedSettingAttribute — deve ser aplicado a toda e qualquer propriedade de configurações.
.gif "Observação") Observação |
|---|
Derivado de um provedor de configurações personalizadas, a SettingsProvider da classe, só é necessário para reconhecer os seguintes três atributos: ApplicationScopedSettingAttribute, UserScopedSettingAttribute, e DefaultSettingValueAttribute. |
Atributo |
Destino |
Descrição |
|---|---|---|
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, LocalFileSettingsProvider, será adotado. |
|
Ambos |
Define uma propriedade como uma configuração do aplicativo de escopo do usuário. |
|
Ambos |
Define uma propriedade como uma configuração do aplicativo de escopo do aplicativo. |
|
Propriedade |
Especifica uma sequência de caracteres que pode ser desserializada pelo provedor para o valor padrão embutido em código desta propriedade. O LocalFileSettingsProvider não exige esse atributo e substituirá qualquer valor fornecido por este atributo se houver um valor já persistido. |
|
Propriedade |
Fornece o teste descritivo para uma configuração individual, usada primariamente por ferramentas em tempo de execução e em tempo de design. |
|
Classe |
Fornece um nome explícito para um grupo de configurações. Se este atributo estiver faltando, ApplicationSettingsBase usa o nome da classe envoltório. |
|
Classe |
Fornece o teste descritivo para uma grupo de configurações, usada primariamente por ferramentas de tempo de execução e de tempo de design. |
|
Ambos |
Especifica zero ou mais serviços de gerenciabilidade que devem ser fornecidos para o grupo ou propriedade de configurações. Os serviços disponíveis são descritos pela enumeração SettingsManageability. |
|
Propriedade |
Indica que uma configuração pertence a uma categoria especial, predefinida, como uma string 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. |
|
Ambos |
Especifica um mecanismo preferencial de serialização para um grupo ou propriedade de configurações. Os mecanismos de serialização disponíveis são definidos pela enumeração SettingsSerializeAs. |
|
Propriedade |
Especifica que um provedor de configurações deve desativar toda a funcionalidade de atualização do aplicativo para a propriedade marcada. |
Classe indica que o atributo pode ser aplicado somente a uma classe envoltório das configurações do 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 um dos dois níveis.
Consulte também
Tarefas
Como: Criar configurações do aplicativo usando o Designer