SettingsProvider Classe

  • Riferimento

Definizione

Spazio dei nomi:
System.Configuration
Assembly:
System.Configuration.ConfigurationManager.dll
Assembly:
System.dll
Pacchetto:
System.Configuration.ConfigurationManager v6.0.0
Pacchetto:
System.Configuration.ConfigurationManager v7.0.0
Pacchetto:
System.Configuration.ConfigurationManager v8.0.0
Pacchetto:
System.Configuration.ConfigurationManager v9.0.0-preview.2.24128.5
Source:
SettingsProvider.cs
Source:
SettingsProvider.cs
Source:
SettingsProvider.cs

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::ProviderBase
public abstract class SettingsProvider : System.Configuration.Provider.ProviderBase
type SettingsProvider = class
    inherit ProviderBase
Public MustInherit Class SettingsProvider
Inherits ProviderBase
Ereditarietà
Object
ProviderBase
SettingsProvider
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:

  1. Se il provider può soddisfare la richiesta implicita dall'attributo, ovviamente dovrebbe farlo.

  2. Se il provider non riesce a soddisfare la richiesta, deve ignorarlo in modo invisibile all'utente.

  3. 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)

Si applica a

Vedi anche