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 capacités étendues pour les fournisseurs de paramètres d'application basés sur les clients.
public interface class IApplicationSettingsProviderpublic interface IApplicationSettingsProvidertype IApplicationSettingsProvider = interfacePublic 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 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. |
