IApplicationSettingsProvider Interfaz

Definición

Define funciones extendidas para los proveedores de configuración de aplicación basada en cliente.

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

Comentarios

La arquitectura de configuración de la aplicación permite proporcionar un mecanismo de almacenamiento personalizado para la configuración de la aplicación mediante la creación de un proveedor de configuración personalizado, que es una clase derivada de SettingsProvider. Esta clase contiene la funcionalidad básica para almacenar y recuperar propiedades. Sin embargo, puede agregar funcionalidad estandarizada adicional mediante la implementación de la IApplicationSettingsProvider interfaz en el proveedor de configuración personalizada. Esta interfaz contiene tres métodos que permiten principalmente al proveedor de configuración controlar de forma más inteligente los cambios de versión de la aplicación. Normalmente, el proveedor de configuración almacenará la configuración de la aplicación para diferentes versiones de una aplicación por separado para prever las siguientes circunstancias:

  • Ejecución en paralelo de diferentes versiones de una aplicación.

  • Conservar la configuración de la aplicación al actualizar una aplicación.

  • Restablecer la configuración de la aplicación a sus valores predeterminados para la versión usada actualmente.

La clase LocalFileSettingsProvider implementa la interfaz IApplicationSettingsProvider. El mismo conjunto de métodos que contiene IApplicationSettingsProvider también se encuentra en la ApplicationSettingsBase clase , lo que permite establecer un canal de comunicación predefinido entre un contenedor de configuración de la aplicación y su proveedor de configuración.

Nota

Esta interfaz es opcional. Si un proveedor no implementa esta interfaz, se producirá un error en la infraestructura de configuración sin notificación si intenta acceder a cualquiera de los métodos definidos por esta interfaz.

Métodos

GetPreviousVersion(SettingsContext, SettingsProperty)

Devuelve el valor de la propiedad de configuración especificada para la versión anterior de la misma aplicación.

Reset(SettingsContext)

Reestablece los valores predeterminados de la configuración de aplicación asociada a la aplicación especificada.

Upgrade(SettingsContext, SettingsPropertyCollection)

Indica al proveedor que se ha actualizado la aplicación. De este modo el proveedor tiene una oportunidad de actualizar su configuración almacenada según resulte conveniente.

Se aplica a

Consulte también