IApplicationSettingsProvider Interface
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit des fonctionnalités étendues pour les fournisseurs de paramètres d’application basés sur le client.
public interface class IApplicationSettingsProvider
public interface IApplicationSettingsProvider
type IApplicationSettingsProvider = interface
Public Interface IApplicationSettingsProvider
- Dérivé
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 plus intelligemment les modifications de version de l’application. En règle générale, le fournisseur de paramètres stocke les paramètres d’application pour différentes versions d’une application séparément pour 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 IApplicationSettingsProvider dans la ApplicationSettingsBase classe permet également l’établissement d’un canal de communication prédéfini entre un wrapper de paramètres d’application et son fournisseur de paramètres.
Note
Cette interface est facultative. Si un fournisseur n’implémente pas cette interface, l’infrastructure des paramètres échoue sans notification si elle tente d’accéder à l’une des méthodes définies par cette interface.
Méthodes
| Nom | Description |
|---|---|
| GetPreviousVersion(SettingsContext, SettingsProperty) |
Retourne la valeur de la propriété de paramètres spécifiée pour la version précédente de la même application. |
| Reset(SettingsContext) |
Réinitialise les paramètres d’application associés à l’application spécifiée à leurs valeurs par défaut. |
| 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. |
S’applique à
Voir aussi
- SettingsProvider
- ApplicationSettingsBase
- architecture des paramètres d’application