IApplicationSettingsProvider Interface
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Define recursos estendidos para provedores de configurações de aplicativo baseados em cliente.
public interface class IApplicationSettingsProviderpublic interface IApplicationSettingsProvidertype IApplicationSettingsProvider = interfacePublic Interface IApplicationSettingsProvider- Derivado
Comentários
A arquitetura de configurações de aplicativo permite que você forneça um mecanismo de armazenamento personalizado para configurações de aplicativo criando um provedor de configurações personalizado, que é uma classe derivada de SettingsProvider. Essa classe contém a funcionalidade básica para armazenar e recuperar propriedades. No entanto, você pode adicionar funcionalidade padronizada adicional implementando a IApplicationSettingsProvider interface no provedor de configurações personalizadas. Essa interface contém três métodos que permitem principalmente que o provedor de configurações lide com as alterações de versão do aplicativo de forma mais inteligente. Normalmente, o provedor de configurações armazenará as configurações do aplicativo para versões diferentes de um aplicativo separadamente para prever as seguintes circunstâncias:
Execução lado a lado de diferentes versões de um aplicativo.
Retendo as configurações do aplicativo ao atualizar um aplicativo.
Redefinindo as configurações do aplicativo para seus valores padrão para a versão usada no momento.
A classe LocalFileSettingsProvider implementa a interface IApplicationSettingsProvider. O mesmo conjunto de métodos contidos também IApplicationSettingsProvider é encontrado na ApplicationSettingsBase classe, permitindo o estabelecimento de um canal de comunicação predefinido entre um wrapper de configurações de aplicativo e seu provedor de configurações.
Note
Essa interface é opcional. Se um provedor não implementar essa interface, a infraestrutura de configurações falhará sem notificação se tentar acessar qualquer um dos métodos definidos por essa interface.
Métodos
| Nome | Description |
|---|---|
| GetPreviousVersion(SettingsContext, SettingsProperty) |
Retorna o valor da propriedade de configurações especificada para a versão anterior do mesmo aplicativo. |
| Reset(SettingsContext) |
Redefine as configurações de aplicativo associadas ao aplicativo especificado para seus valores padrão. |
| Upgrade(SettingsContext, SettingsPropertyCollection) |
Indica ao provedor que o aplicativo foi atualizado. Isso oferece ao provedor uma oportunidade de atualizar suas configurações armazenadas conforme apropriado. |
Aplica-se a
Confira também
- SettingsProvider
- ApplicationSettingsBase
- arquitetura de configurações do aplicativo
