Exporter (0) Imprimer
Développer tout
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

UserScopedSettingAttribute, classe

Mise à jour : novembre 2007

Spécifie qu'une propriété ou un groupe de paramètres d'application contient des valeurs distinctes pour chaque utilisateur d'une application. Cette classe ne peut pas être héritée.

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

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

Les propriétés de paramètres d'application ont une portée basée au niveau de l'application ou de l'utilisateur. Comme l'impliquent les catégories, les propriétés de portée application présentent des valeurs uniformes à tous les utilisateurs de l'application, alors que les propriétés de portée utilisateur ont des valeurs dédiées pour chaque utilisateur de l'application.

UserScopedSettingAttribute indique qu'une propriété doit être considérée comme un paramètre de niveau utilisateur et que des décisions de stockage appropriées doivent être prises en conséquence par le fournisseur de paramètres.

Un attribut de portée est requis pour chaque propriété de paramètres d'application. Si une propriété n'est pas appliquée avec ApplicationScopedSettingAttribute ou UserScopedSettingAttribute, elle est ignorée par le fournisseur de paramètres (elle n'est pas sérialisée). Toutefois, l'attribution des deux attributs à la même propriété de paramètres n'est pas une opération valide. Une telle tentative provoquera la levée d'une exception ConfigurationErrorsException.

L'exemple de code suivant illustre l'utilisation de UserScopedSettingAttribute appliqué aux 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. 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.SettingAttribute
      System.Configuration.UserScopedSettingAttribute
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
Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft. Tous droits réservés.