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: |
|---|
Um provedor de configurações personalizadas, derivado de SettingsProvider classe, é necessário apenas para reconhecer três atributos a seguir: ApplicationScopedSettingAttribute, UserScopedSettingAttribute, and 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
Conceitos
Arquitetura das Configurações do Aplicativo