Attributs des paramètres d'application
Mise à jour : novembre 2007
L'architecture des paramètres d'application fournit un grand nombre d'attributs qui peuvent être appliqués à la classe wrapper de paramètres d'application ou à ses propriétés individuelles. Ces attributs sont examinés au moment de l'exécution par l'infrastructure de paramètres d'application, souvent représentée spécifiquement par le fournisseur de paramètres, afin d'adapter son fonctionnement aux besoins énoncés du wrapper personnalisé.
Le tableau suivant répertorie les attributs qui peuvent s'appliquer à la classe wrapper de paramètres d'application, aux propriétés individuelles de cette classe, ou aux deux. Par définition, seul un attribut de portée unique (UserScopedSettingAttribute ou ApplicationScopedSettingAttribute) doit être appliqué à chaque propriété de paramètres.
Remarque : |
---|
Un fournisseur de paramètres personnalisé dérivé de la classe SettingsProvider n'est requis que pour la reconnaissance des trois attributs suivants : ApplicationScopedSettingAttribute, UserScopedSettingAttribute et DefaultSettingValueAttribute. |
Attribut |
Cible |
Description |
---|---|---|
Les deux |
Spécifie le nom court du fournisseur de paramètres à utiliser pour la persistance. Si cet attribut n'est pas fourni, le fournisseur par défaut, LocalFileSettingsProvider, est utilisé. |
|
Les deux |
Définit une propriété en tant que paramètre d'application de portée utilisateur. |
|
Les deux |
Définit une propriété en tant que paramètre d'application de portée application. |
|
Propriété |
Spécifie une chaîne qui peut être désérialisée par le fournisseur en valeur par défaut codée de manière irréversible pour cette propriété. LocalFileSettingsProvider ne requiert pas cet attribut, et se substituera à toute valeur fournie par cet attribut (s'il comporte déjà une valeur persistante). |
|
Propriété |
Fournit le test descriptif d'un paramètre individuel, utilisé à l'origine par les outils d'exécution et de design. |
|
Classe |
Fournit un nom explicite pour un groupe de paramètres. Si cet attribut est manquant, ApplicationSettingsBase utilise le nom de classe wrapper. |
|
Classe |
Fournit le test descriptif d'un groupe de paramètres, utilisé à l'origine par les outils d'exécution et de design. |
|
Les deux |
Spécifie le nombre de services de maniabilité (zéro ou davantage) à fournir au groupe de paramètres ou à la propriété. Les services disponibles sont décrits par l'énumération SettingsManageability. |
|
Propriété |
Indique qu'un paramètre appartient à une catégorie spécifique, prédéfinie (telle qu'une chaîne de connexion) qui suggère un traitement spécifique par le fournisseur de paramètres. Les catégories prédéfinies pour cet attribut sont définies par l'énumération SpecialSetting. |
|
Les deux |
Spécifie un mécanisme de sérialisation par défaut pour un groupe de paramètres ou pour une propriété. Les mécanismes de sérialisation disponibles sont définis par l'énumération SettingsSerializeAs. |
|
Propriété |
Spécifie qu'un fournisseur de paramètres doit désactiver toutes les fonctionnalités de mise à niveau de l'application pour la propriété marquée. |
Classe indique que l'attribut peut être appliqué uniquement à une classe wrapper de paramètres d'application. Propriété indique que l'attribut peut être appliqué uniquement aux propriétés de paramètres. Les deux indique que l'attribut peut être appliqué aux deux niveaux.
Voir aussi
Tâches
Comment : créer des paramètres d'application à l'aide du concepteur
Concepts
Architecture des paramètres d'application