SettingsProvider Classe
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.
Agit comme classe de base pour la dérivation de fournisseurs de paramètres personnalisés dans l'architecture de paramètres d'application.
public ref class SettingsProvider abstract : System::Configuration::Provider::ProviderBase
public abstract class SettingsProvider : System.Configuration.Provider.ProviderBase
type SettingsProvider = class
inherit ProviderBase
Public MustInherit Class SettingsProvider
Inherits ProviderBase
- Héritage
- Dérivé
Remarques
Un fournisseur de paramètres définit le mécanisme de stockage des données de configuration utilisées dans l’architecture des paramètres d’application. Le .NET Framework contient un seul fournisseur de paramètres par défaut, LocalFileSettingsProvider, qui stocke les données de configuration dans le système de fichiers local. Toutefois, vous pouvez créer d’autres mécanismes de stockage en dérivant de la classe abstraite SettingsProvider . Le fournisseur utilisé par une classe wrapper est déterminé en décorant la classe wrapper avec le SettingsProviderAttribute. Si cet attribut n’est pas fourni, la valeur par défaut, LocalFileSettingsProvider, est utilisée.
Lorsque vous créez un fournisseur de paramètres personnalisés, au minimum, vous devez fournir des implémentations pour les trois méthodes de cette classe : GetPropertyValues, SetPropertyValues et ApplicationName.
Pour les applications clientes, vous pouvez ajouter des fonctionnalités plus standardisées à un fournisseur personnalisé en implémentant également l’interface IApplicationSettingsProvider . Cette interface reflète les méthodes trouvées dans la ApplicationSettingsBase classe , ce qui permet principalement la prise en charge du contrôle de version.
En règle générale, vous devez concevoir des fournisseurs de paramètres à instance unique afin d’éviter la contention des ressources de stockage. Les fournisseurs doivent également être thread-safe, car ils peuvent être appelés simultanément à partir de plusieurs instances wrapper dans un domaine d’application unique ou à partir de plusieurs applications dans différents domaines.
Au minimum, un fournisseur de paramètres doit reconnaître trois attributs : ApplicationScopedSettingAttribute, UserScopedSettingAttributeet DefaultSettingValueAttribute. Pour obtenir la liste complète des attributs qui peuvent être appliqués aux paramètres d’application, consultez Attributs des paramètres d’application. Un fournisseur de paramètres personnalisés doit résoudre les attributs appliqués aux propriétés de paramètres de la manière suivante :
Si le fournisseur peut répondre à la demande impliquée par l’attribut, il doit évidemment le faire.
Si le fournisseur ne peut pas répondre à la demande, il doit l’ignorer silencieusement.
Si au moins deux propriétés sont en conflit ; par exemple, une propriété décorée à la fois ApplicationScopedSettingAttribute avec et UserScopedSettingAttribute; le fournisseur doit lever un ConfigurationException.
Constructeurs
SettingsProvider() |
Initialise une instance de la classe SettingsProvider. |
Propriétés
ApplicationName |
Obtient ou définit le nom de l'application en cours d'exécution. |
Description |
Obtient une description brève et conviviale qui peut s'afficher dans les outils d'administration ou d'autres interfaces utilisateur. (Hérité de ProviderBase) |
Name |
Obtient le nom convivial qui référence le fournisseur au cours de la configuration. (Hérité de ProviderBase) |
Méthodes
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetPropertyValues(SettingsContext, SettingsPropertyCollection) |
Retourne la collection de valeurs de propriétés de paramètres pour l'instance d'application et le groupe de propriétés de paramètres spécifiés. |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
Initialize(String, NameValueCollection) |
Initialise le générateur de configuration. (Hérité de ProviderBase) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) |
Définit les valeurs du groupe de paramètres de propriétés spécifié. |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |