SettingsProvider Classe

Définition

Espace de noms:
System.Configuration
Assembly:
System.dll

Agit comme classe de base pour dériver des fournisseurs de paramètres personnalisés dans l’architecture des 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é

Remarques

Un fournisseur de paramètres définit le mécanisme permettant de stocker les données de configuration utilisées dans l’architecture des paramètres de l’application. .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 qu’utilise 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 est LocalFileSettingsProviderutilisé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 : GetPropertyValueset SetPropertyValuesApplicationName.

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 met en miroir 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 pour qu’ils soient à instance unique pour é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 de 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é doit résoudre les attributs appliqués aux propriétés des paramètres de la manière suivante :

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

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

  3. Si deux propriétés ou plus sont en conflit ; par exemple, une propriété décorée avec les deux ApplicationScopedSettingAttribute et UserScopedSettingAttribute; le fournisseur doit lever un ConfigurationException.

Constructeurs

Nom Description
SettingsProvider()

Initialise une instance de la SettingsProvider classe.

Propriétés

Nom Description
ApplicationName

Obtient ou définit le nom de l’application en cours d’exécution.
Description

Obtient une brève description conviviale adaptée à l’affichage dans les outils d’administration ou d’autres interfaces utilisateur (UIs).

(Hérité de ProviderBase)
Name

Obtient le nom convivial utilisé pour faire référence au fournisseur pendant la configuration.

(Hérité de ProviderBase)

Méthodes

Nom Description
Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetPropertyValues(SettingsContext, SettingsPropertyCollection)

Retourne la collection de valeurs de propriété de paramètres pour l’instance d’application et le groupe de propriétés de paramètres spécifiés.
GetType()

Obtient la 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 Objectactuel.

(Hérité de Object)
SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)

Définit les valeurs du groupe spécifié de paramètres de propriété.
ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)

S’applique à

Voir aussi