IApplicationSettingsProvider Interface

Definição

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacote:

System.Configuration.ConfigurationManager v8.0.0

Origem:

IApplicationSettingsProvider.cs

Define os recursos estendidos para provedores de configurações de aplicativo baseados no cliente.

C#

public interface IApplicationSettingsProvider

Derivado

System.Configuration.LocalFileSettingsProvider

System.Web.ClientServices.Providers.ClientSettingsProvider

Comentários

A arquitetura de configurações do aplicativo permite que você forneça um mecanismo de armazenamento personalizado para as configurações do aplicativo criando um provedor de configurações personalizadas, 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 mais inteligência as alterações de versão do aplicativo. 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.

• Mantendo 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 por IApplicationSettingsProvider também é 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.

Observação

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

GetPreviousVersion(SettingsContext, SettingsProperty)	Retorna o valor da propriedade de configuração 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 o provedor a oportunidade de atualizar as respectivas configurações armazenadas conforme apropriado.

Aplica-se a

Confira também

• SettingsProvider
• ApplicationSettingsBase
• Arquitetura das configurações do aplicativo