IApplicationSettingsProvider Interface

Définition

Espace de noms:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paquet:

System.Configuration.ConfigurationManager v8.0.0

Source:

IApplicationSettingsProvider.cs

Définit des capacités étendues pour les fournisseurs de paramètres d'application basés sur les clients.

public interface class IApplicationSettingsProvider

public interface IApplicationSettingsProvider

type IApplicationSettingsProvider = interface

Public Interface IApplicationSettingsProvider

Dérivé

System.Configuration.LocalFileSettingsProvider

System.Web.ClientServices.Providers.ClientSettingsProvider

Remarques

L’architecture des paramètres d’application vous permet de fournir un mécanisme de stockage personnalisé pour les paramètres d’application en créant un fournisseur de paramètres personnalisés, qui est une classe dérivée de SettingsProvider. Une telle classe contient les fonctionnalités de base pour le stockage et la récupération des propriétés. Toutefois, vous pouvez ajouter des fonctionnalités standardisées supplémentaires en implémentant l’interface IApplicationSettingsProvider dans le fournisseur de paramètres personnalisés. Cette interface contient trois méthodes qui permettent principalement au fournisseur de paramètres de gérer de manière plus intelligente les modifications de version de l’application. En règle générale, le fournisseur de paramètres stocke séparément les paramètres d’application pour différentes versions d’une application afin d’anticiper les circonstances suivantes :

• Exécution côte à côte de différentes versions d’une application.

• Conservation des paramètres d’application lors de la mise à niveau d’une application.

• Réinitialisation des paramètres d’application à leurs valeurs par défaut pour la version actuellement utilisée.

La classe LocalFileSettingsProvider implémente l’interface IApplicationSettingsProvider. Le même ensemble de méthodes contenues par IApplicationSettingsProvider se trouve également dans la ApplicationSettingsBase classe, ce qui permet d’établir un canal de communication prédéfini entre un wrapper de paramètres d’application et son fournisseur de paramètres.

Notes

Cette interface est facultative. Si un fournisseur n’implémente pas cette interface, l’infrastructure des paramètres échoue sans notification s’il tente d’accéder à l’une des méthodes définies par cette interface.

Méthodes

GetPreviousVersion(SettingsContext, SettingsProperty)	Retourne la valeur de la propriété de paramètres spécifiée pour la version antérieure de la même application.
Reset(SettingsContext)	Restaure les valeurs par défaut des paramètres d'application associés à l'application spécifiée.
Upgrade(SettingsContext, SettingsPropertyCollection)	Indique au fournisseur que l'application a été mise à niveau. Cela offre au fournisseur la possibilité de mettre à niveau ses paramètres stockés selon les besoins.

Voir aussi

• SettingsProvider
• ApplicationSettingsBase
• Architecture des paramètres d'application