Exporter (0) Imprimer
Développer tout

DefaultSettingValueAttribute, classe

Mise à jour : novembre 2007

Spécifie la valeur par défaut d'une propriété de paramètre d'application.

Espace de noms :  System.Configuration
Assembly :  System (dans System.dll)

[AttributeUsageAttribute(AttributeTargets.Property)]
public sealed class DefaultSettingValueAttribute : Attribute
/** @attribute AttributeUsageAttribute(AttributeTargets.Property) */
public final class DefaultSettingValueAttribute extends Attribute
public final class DefaultSettingValueAttribute extends Attribute

Remarque importante :

DefaultSettingValueAttribute peut être appliqué uniquement à des propriétés de paramètres ; l'attribution de cet attribut à l'ensemble d'une classe de paramètres d'application n'est pas valide.

Différents fournisseurs de paramètres peuvent avoir différentes exigences ou des limitations quant à l'utilisation de DefaultSettingValueAttribute. Par exemple, LocalFileSettingsProvider ne requiert pas cet attribut et substituera toute valeur fournie par cet attribut si des valeurs (par défaut ou modifiées par l'utilisateur) sont déjà présentes dans le magasin de données.

DefaultSettingValueAttribute requiert que la valeur par défaut puisse être représentée en tant que chaîne. En conséquence, les paramètres qui utilisent la sérialisation XML ne peuvent pas avoir de valeur par défaut spécifiée au moyen de cet attribut. Certains fournisseurs peuvent choisir de prendre en charge plusieurs méthodes de sérialisation qui peuvent être spécifiées au moment de la compilation à l'aide de SettingsSerializeAsAttribute.

Attention :

Les valeurs par défaut spécifiées par cet attribut sont stockées comme texte brut dans le fichier .exe ou .dll compilé résultant. Par conséquent, ces valeurs par défaut sont fondamentalement incertaines.

L'exemple de code suivant illustre l'utilisation de DefaultSettingValueAttribute appliqué à trois des quatre propriétés de la classe wrapper FormSettings, qui est dérivée de la classe ApplicationSettingsBase. Cette classe est utilisée pour rendre persistants l'emplacement, la taille, la couleur d'arrière-plan et le texte de formulaire. Les trois premières de ces propriétés de formulaire ont des valeurs par défaut qui leur sont associées.

L'exemple de code complet est répertorié dans la vue d'ensemble de la classe ApplicationSettingsBase.

//Application settings wrapper class
sealed class FormSettings : ApplicationSettingsBase
{
    [UserScopedSettingAttribute()]
    public String FormText
    {
        get { return (String)this["FormText"]; }
        set { this["FormText"] = value; }
    }

    [UserScopedSettingAttribute()]
    [DefaultSettingValueAttribute("0, 0")]
    public Point FormLocation
    {
        get { return (Point)(this["FormLocation"]); }
        set { this["FormLocation"] = value; }
    }

    [UserScopedSettingAttribute()]
    [DefaultSettingValueAttribute("225, 200")]
    public Size FormSize
    {
        get { return (Size)this["FormSize"]; }
        set { this["FormSize"] = value; }
    }


    [UserScopedSettingAttribute()]
    [DefaultSettingValueAttribute("LightGray")]
    public Color FormBackColor
    {
        get { return (Color)this["FormBackColor"]; }
        set { this["FormBackColor"] = value; }
    }

}


System.Object
  System.Attribute
    System.Configuration.DefaultSettingValueAttribute

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft