IApplicationSettingsProvider Interface

  • Referência

Definição

Namespace:
System.Configuration
Assembly:
System.Configuration.ConfigurationManager.dll
Assembly:
System.dll
Pacote:
System.Configuration.ConfigurationManager v6.0.0
Pacote:
System.Configuration.ConfigurationManager v7.0.0
Pacote:
System.Configuration.ConfigurationManager v8.0.0
Pacote:
System.Configuration.ConfigurationManager v9.0.0-preview.2.24128.5
Origem:
IApplicationSettingsProvider.cs
Origem:
IApplicationSettingsProvider.cs
Origem:
IApplicationSettingsProvider.cs

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

public interface class IApplicationSettingsProvider
public interface IApplicationSettingsProvider
type IApplicationSettingsProvider = interface
Public Interface IApplicationSettingsProvider
Derivado

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