Attributi delle impostazioni delle applicazioniApplication Settings Attributes

L'architettura di impostazioni dell'applicazione fornisce numerosi attributi che possono essere applicati per la classe wrapper di impostazioni o alle singole proprietà.The Application Settings architecture provides many attributes that can be applied either to the applications settings wrapper class or its individual properties. Questi attributi vengono esaminati in fase di esecuzione per l'infrastruttura di impostazioni dell'applicazione, spesso in modo specifico il provider di impostazioni, per adattare il suo funzionamento alle esigenze del wrapper personalizzate dichiarate.These attributes are examined at run time by the application settings infrastructure, often specifically the settings provider, in order to tailor its functioning to the stated needs of the custom wrapper.

Nella tabella seguente elenca gli attributi che possono essere applicati per la classe wrapper delle impostazioni dell'applicazione, le singole proprietà di questa classe o entrambi.The following table lists the attributes that can be applied to the application settings wrapper class, this class's individual properties, or both. Per definizione, un attributo singolo ambito, ovveroUserScopedSettingAttribute oppure ApplicationScopedSettingAttribute, deve essere applicato a tutte le proprietà delle impostazioni.By definition, only a single scope attribute—UserScopedSettingAttribute or ApplicationScopedSettingAttribute—must be applied to each and every settings property.

Nota

Un provider di impostazioni personalizzato, derivato dal SettingsProvider classe, è richiesto solo per riconoscere i tre attributi seguenti: ApplicationScopedSettingAttribute, UserScopedSettingAttribute, e DefaultSettingValueAttribute.A custom settings provider, derived from the SettingsProvider class, is only required to recognize the following three attributes: ApplicationScopedSettingAttribute, UserScopedSettingAttribute, and DefaultSettingValueAttribute.

AttributoAttribute destinazioneTarget DescrizioneDescription
SettingsProviderAttribute EntrambiBoth Specifica il nome breve del provider di impostazioni da utilizzare per la persistenza.Specifies the short name of the settings provider to use for persistence.

Se questo attributo viene omesso, il provider predefinito, LocalFileSettingsProvider, verrà utilizzato.If this attribute is not supplied, the default provider, LocalFileSettingsProvider, is assumed.
UserScopedSettingAttribute EntrambiBoth Definisce una proprietà come un'impostazione con ambito di utente dell'applicazione.Defines a property as a user-scoped application setting.
ApplicationScopedSettingAttribute EntrambiBoth Definisce una proprietà come un'impostazione con ambito di applicazione dell'applicazione.Defines a property as an application-scoped application setting.
DefaultSettingValueAttribute ProprietàProperty Specifica una stringa che può essere deserializzata dal provider nel valore predefinito hardcoded per questa proprietà.Specifies a string that can be deserialized by the provider into the hard-coded default value for this property.

Il LocalFileSettingsProvider non richiede questo attributo e ignorerà qualsiasi valore fornito da questo attributo se non esiste già un valore persistente.The LocalFileSettingsProvider does not require this attribute, and will override any value provided by this attribute if there is a value already persisted.
SettingsDescriptionAttribute ProprietàProperty Fornisce il testo descrittivo per una singola impostazione, usata principalmente dagli strumenti di runtime e fase di progettazione.Provides the descriptive test for an individual setting, used primarily by run-time and design-time tools.
SettingsGroupNameAttribute ClasseClass Fornisce un nome esplicito per un gruppo di impostazioni.Provides an explicit name for a settings group. Se questo attributo è manca, ApplicationSettingsBase Usa il nome della classe wrapper.If this attribute is missing, ApplicationSettingsBase uses the wrapper class name.
SettingsGroupDescriptionAttribute ClasseClass Fornisce il testo descrittivo per un gruppo di impostazioni utilizzato principalmente dagli strumenti di runtime e fase di progettazione.Provides the descriptive test for a settings group, used primarily by run-time and design-time tools.
SettingsManageabilityAttribute EntrambiBoth Specifica zero o più servizi la facilità di gestione che devono essere forniti per il gruppo di impostazioni o proprietà.Specifies zero or more manageability services that should be provided to the settings group or property. I servizi disponibili sono descritti dal SettingsManageability enumerazione.The available services are described by the SettingsManageability enumeration.
SpecialSettingAttribute ProprietàProperty Indica che un'impostazione appartiene a una categoria predefinita, speciale, ad esempio una stringa di connessione, che suggerisce un'elaborazione speciale per il provider di impostazioni.Indicates that a setting belongs to a special, predefined category, such as a connection string, that suggests special processing by the settings provider. Le categorie predefinite per questo attributo sono definite dal SpecialSetting enumerazione.The predefined categories for this attribute are defined by the SpecialSetting enumeration.
SettingsSerializeAsAttribute EntrambiBoth Specifica un meccanismo di serializzazione preferito per un gruppo di impostazioni o proprietà.Specifies a preferred serialization mechanism for a settings group or property. I meccanismi di serializzazione sono definiti dal SettingsSerializeAs enumerazione.The available serialization mechanisms are defined by the SettingsSerializeAs enumeration.
NoSettingsVersionUpgradeAttribute ProprietàProperty Specifica che un provider di impostazioni deve disabilitare tutte le funzionalità di aggiornamento dell'applicazione per la proprietà contrassegnata.Specifies that a settings provider should disable all application upgrade functionality for the marked property.

Classe indica che l'attributo può essere applicato solo a una classe wrapper di impostazioni dell'applicazione.Class indicates that the attribute can be applied only to an application settings wrapper class. Proprietà indica che l'attributo può essere applicato solo alle proprietà delle impostazioni.Property indicates that the attribute can be applied only settings properties. Entrambi indica che l'attributo può essere applicato a qualsiasi livello.Both indicates that the attribute can be applied at either level.

Vedere ancheSee also