Classe UserScopedSettingAttribute

Le proprietà delle impostazioni delle applicazioni hanno un ambito in base all'applicazione o a livello di utente. Come le categorie stessi, valori uniformi presentano delle proprietà con ambito applicazione a tutti gli utenti dell'applicazione, mentre le proprietà con ambito utente hanno dedicato i valori per ciascun utente.

UserScopedSettingAttribute indica che una proprietà deve essere considerata un'installazione a livello di utente e che le decisioni appropriate di archiviazione devono essere eseguite pertanto dal provider di impostazioni.

Un attributo di ambito è obbligatorio per ogni proprietà delle impostazioni dell'applicazione. Se una proprietà non è applicabile a uno un oggetto ApplicationScopedSettingAttribute o UserScopedSettingAttribute, la proprietà viene ignorata dalle impostazioni che provider-non viene serializzato. Non è valido, tuttavia, implementare entrambi gli attributi alla stessa proprietà delle impostazioni. Un tentativo genera un'eccezione ConfigurationErrorsException per essere generato.

Nell'esempio di codice seguente viene illustrato l'utilizzo di UserScopedSettingAttribute applicato a tutte e quattro le proprietà di FormSettings classe wrapper, che deriva da ApplicationSettingsBase classe. Questa classe viene utilizzata per mantenere la posizione, la dimensione, il colore di sfondo e il testo del form. l'esempio di codice completo è elencato in ApplicationSettingsBase panoramica della classe.

//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; }
    }

}

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

Riferimenti

Altre risorse