Leggere in inglese

Condividi tramite


DefaultSettingValueAttribute Classe

Definizione

Specifica il valore predefinito per una proprietà delle impostazioni dell'applicazione.

[System.AttributeUsage(System.AttributeTargets.Property)]
public sealed class DefaultSettingValueAttribute : Attribute
Ereditarietà
DefaultSettingValueAttribute
Attributi

Esempio

Nell'esempio di codice seguente viene illustrato l'uso dell'oggetto DefaultSettingValueAttribute applicato a tre delle quattro proprietà della FormSettings classe wrapper, derivata dalla ApplicationSettingsBase classe . Questa classe viene usata per rendere persistente la posizione, le dimensioni, il colore di sfondo e il testo del modulo. Le prime tre di queste proprietà del modulo hanno valori predefiniti associati.

L'esempio di codice completo è elencato nella panoramica della ApplicationSettingsBase 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; }
    }
}

Commenti

Importante

DefaultSettingValueAttribute può essere applicato solo alle singole proprietà delle impostazioni; non è valido applicare questo attributo a un'intera classe di impostazioni dell'applicazione.

I diversi provider di impostazioni possono avere requisiti o limitazioni diversi sull'uso di DefaultSettingValueAttribute. Ad esempio, non LocalFileSettingsProvider richiede questo attributo e eseguirà l'override di qualsiasi valore fornito da questo attributo se sono presenti valori, impostazione predefinita o modificata dall'utente, già presenti nell'archivio dati.

DefaultSettingValueAttribute richiede che il valore predefinito possa essere rappresentato come stringa. Di conseguenza, le impostazioni che usano la serializzazione XML non possono avere un valore predefinito specificato tramite questo attributo. Alcuni provider possono scegliere di supportare più schemi di serializzazione che possono essere specificati in fase di compilazione usando .SettingsSerializeAsAttribute

Attenzione

I valori predefiniti specificati da questo attributo vengono archiviati come testo normale nel file compilato .exe o .dll risultante. Pertanto questi valori predefiniti sono intrinsecamente insicuri.

Costruttori

Proprietà

TypeId

Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute.

(Ereditato da Attribute)
Value

Ottiene il valore predefinito per la proprietà delle impostazioni dell'applicazione.

Metodi

Equals(Object)

Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.

(Ereditato da Attribute)
GetHashCode()

Restituisce il codice hash per l'istanza.

(Ereditato da Attribute)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
IsDefaultAttribute()

In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata.

(Ereditato da Attribute)
Match(Object)

Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato.

(Ereditato da Attribute)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch.

(Ereditato da Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia.

(Ereditato da Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).

(Ereditato da Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornisce l'accesso a proprietà e metodi esposti da un oggetto.

(Ereditato da Attribute)

Si applica a

Vedi anche