IApplicationSettingsProvider Interface

Definição

Define os recursos estendidos para provedores de configurações de aplicativo baseados no cliente.Defines extended capabilities for client-based application settings providers.

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.The application settings architecture enables you to provide a custom storage mechanism for application settings by creating a custom settings provider, which is a class derived from SettingsProvider. Tal classe contém a funcionalidade básica para armazenar e recuperar propriedades.Such a class contains the basic functionality for storing and retrieving properties. No entanto, você pode adicionar funcionalidade padronizada adicional implementando a interface IApplicationSettingsProvider no provedor de configurações personalizadas.However, you can add additional standardized functionality by implementing the IApplicationSettingsProvider interface in the custom settings provider. Essa interface contém três métodos que habilitam principalmente o provedor de configurações para tratar de forma mais inteligente as alterações de versão do aplicativo.This interface contains three methods that primarily enable the settings provider to more intelligently handle application version changes. Normalmente, o provedor de configurações armazenará as configurações de aplicativo para diferentes versões de um aplicativo separadamente para antecipar as seguintes circunstâncias:Typically, the settings provider will store application settings for different versions of an application separately to anticipate the following circumstances:

  • Execução lado a lado de versões diferentes de um aplicativo.Side-by-side execution of different versions of an application.

  • Retenção de configurações de aplicativo ao atualizar um aplicativo.Retaining application settings when upgrading an application.

  • Redefinindo as configurações do aplicativo para seus valores padrão para a versão atualmente usada.Resetting the application settings to their default values for the currently used version.

A classe LocalFileSettingsProvider implementa a interface IApplicationSettingsProvider.The LocalFileSettingsProvider class implements the IApplicationSettingsProvider interface. O mesmo conjunto de métodos contido por IApplicationSettingsProvider também é encontrado na classe ApplicationSettingsBase, permitindo o estabelecimento de um canal de comunicação predefinido entre um wrapper de configurações do aplicativo e seu provedor de configurações.The same set of methods contained by IApplicationSettingsProvider is also found in the ApplicationSettingsBase class, enabling the establishment of a predefined communication channel between an application settings wrapper and its settings provider.

Observação

Essa interface é opcional.This interface is optional. 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.If a provider does not implement this interface, the settings infrastructure will fail without notification if it attempts to access any of the methods defined by this interface.

Métodos

GetPreviousVersion(SettingsContext, SettingsProperty)

Retorna o valor da propriedade de configuração especificada para a versão anterior do mesmo aplicativo.Returns the value of the specified settings property for the previous version of the same application.

Reset(SettingsContext)

Redefine as configurações de aplicativo associadas ao aplicativo especificado para seus valores padrão.Resets the application settings associated with the specified application to their default values.

Upgrade(SettingsContext, SettingsPropertyCollection)

Indica ao provedor que o aplicativo foi atualizado.Indicates to the provider that the application has been upgraded. Isso oferece o provedor a oportunidade de atualizar as respectivas configurações armazenadas conforme apropriado.This offers the provider an opportunity to upgrade its stored settings as appropriate.

Aplica-se a

Veja também