SettingsProvider Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Funge da classe base per i provider di impostazioni personalizzati derivati nell'architettura di impostazioni dell'applicazione.
public ref class SettingsProvider abstract : System::Configuration::Provider::ProviderBasepublic abstract class SettingsProvider : System.Configuration.Provider.ProviderBasetype SettingsProvider = class
inherit ProviderBasePublic MustInherit Class SettingsProvider
Inherits ProviderBase- Ereditarietà
- Derivato
Commenti
Un provider di impostazioni definisce il meccanismo per l'archiviazione dei dati di configurazione usati nell'architettura delle impostazioni dell'applicazione. .NET Framework contiene un singolo provider di impostazioni predefinite, che LocalFileSettingsProviderarchivia i dati di configurazione nel file system locale. È tuttavia possibile creare meccanismi di archiviazione alternativi derivando dalla classe astratta SettingsProvider . Il provider utilizzato da una classe wrapper è determinato dalla decorazione della classe wrapper con .SettingsProviderAttribute Se questo attributo non viene specificato, viene usato il valore predefinito , LocalFileSettingsProvider.
Quando si crea un provider di impostazioni personalizzate, almeno, è necessario fornire implementazioni per i tre metodi di questa classe: GetPropertyValuese SetPropertyValuesApplicationName.
Per le applicazioni client, è possibile aggiungere funzionalità più standardizzate a un provider personalizzato implementando anche l'interfaccia IApplicationSettingsProvider . Questo metodo di interfaccia riflette i metodi trovati nella classe, che consente principalmente il supporto per il ApplicationSettingsBase controllo delle versioni.
In genere, è necessario progettare i provider di impostazioni per essere a istanza singola per evitare la contesa delle risorse di archiviazione. I provider devono anche essere thread-safe perché possono essere chiamati simultaneamente da più istanze wrapper in un singolo dominio applicazione o da più applicazioni in domini diversi.
Almeno, un provider di impostazioni deve riconoscere tre attributi - ApplicationScopedSettingAttribute, UserScopedSettingAttributee DefaultSettingValueAttribute. Per un elenco completo degli attributi che possono essere applicati alle impostazioni dell'applicazione, vedere Attributi delle impostazioni applicazione. Un provider di impostazioni personalizzato deve risolvere gli attributi applicati alle proprietà delle impostazioni nel modo seguente:
Se il provider può soddisfare la richiesta implicita dall'attributo, ovviamente dovrebbe farlo.
Se il provider non riesce a soddisfare la richiesta, deve ignorarlo in modo invisibile all'utente.
Se due o più proprietà sono in conflitto; ad esempio, una proprietà decorata con entrambi ApplicationScopedSettingAttribute e UserScopedSettingAttribute; il provider deve generare un ConfigurationExceptionoggetto .
Costruttori
| SettingsProvider() |
Inizializza un'istanza della classe SettingsProvider. |
Proprietà
| ApplicationName |
Ottiene o imposta il nome dell'applicazione attualmente in esecuzione. |
| Description |
Ottiene una breve descrizione di facile comprensione che è possibile visualizzare in strumenti di amministrazione o in altre interfacce utente (UI, User Interface). (Ereditato da ProviderBase) |
| Name |
Ottiene il nome descrittivo utilizzato per fare riferimento al provider durante la configurazione. (Ereditato da ProviderBase) |
Metodi
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetPropertyValues(SettingsContext, SettingsPropertyCollection) |
Restituisce l'insieme di valori delle proprietà delle impostazioni per l'istanza dell'applicazione specificata e per il gruppo di proprietà delle impostazioni. |
| GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
| Initialize(String, NameValueCollection) |
Inizializza il generatore di configurazione. (Ereditato da ProviderBase) |
| MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
| SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) |
Imposta i valori del gruppo specificato di impostazioni delle proprietà. |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
