SettingsProvider Classe

Définition

Espace de noms:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paquet:

System.Configuration.ConfigurationManager v8.0.0

Source:

SettingsProvider.cs

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

Object

ProviderBase

SettingsProvider

Dérivé

System.Configuration.LocalFileSettingsProvider

System.Web.ClientServices.Providers.ClientSettingsProvider

System.Web.Profile.ProfileProvider

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 :

1. Si le fournisseur peut répondre à la demande impliquée par l’attribut, il doit évidemment le faire.

2. Si le fournisseur ne peut pas répondre à la demande, il doit l’ignorer silencieusement.

3. 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)

Voir aussi

• IApplicationSettingsProvider
• LocalFileSettingsProvider
• SettingsProviderAttribute
• ApplicationSettingsBase
• ConfigurationException
• Architecture des paramètres d'application
• Attributs des paramètres d'application