LocalFileSettingsProvider 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.
Fornisce la persistenza per le classi di impostazioni dell'applicazione.
public ref class LocalFileSettingsProvider : System::Configuration::SettingsProvider, System::Configuration::IApplicationSettingsProviderpublic class LocalFileSettingsProvider : System.Configuration.SettingsProvider, System.Configuration.IApplicationSettingsProvidertype LocalFileSettingsProvider = class
inherit SettingsProvider
interface IApplicationSettingsProviderPublic Class LocalFileSettingsProvider
Inherits SettingsProvider
Implements IApplicationSettingsProvider- Ereditarietà
- Implementazioni
Commenti
L'impostazione dei provider definisce un meccanismo per l'archiviazione dei dati di configurazione usati nell'architettura delle impostazioni dell'applicazione. .NET Framework contiene un singolo provider di impostazioni predefinito, LocalFileSettingsProvider, che archivia i dati di configurazione nel file system locale. Una proprietà o un gruppo di proprietà delle impostazioni dell'applicazione sono associati a un provider di impostazioni specifico tramite l'uso di SettingsProviderAttribute.
In genere, il programma client non accede in modo esplicito a questa classe; l'architettura delle impostazioni dell'applicazione richiama automaticamente il provider di impostazioni appropriato quando sono necessari i servizi. Ad esempio, molti membri di ApplicationSettingsBase delegano il proprio lavoro al provider di impostazioni associato.
LocalFileSettingsProvider rende persistenti le impostazioni dei file di configurazione con estensione .config. Il contenuto dei file di configurazione è strutturato come documenti XML. A seconda che l'impostazione abbia un ambito a livello di applicazione o di utente, i dati di configurazione vengono archiviati rispettivamente come elementi all'interno di un <applicationSettings><userSettings> gruppo di sezioni o . Ognuno di questi gruppi di sezioni è rappresentato rispettivamente da un oggetto o ClientSettingsSectioncorrispondenteAppSettingsSection. Ogni oggetto sezione è di proprietà e amministrato da un gestore di sezioni di configurazione, che è un oggetto di tipo IConfigurationSectionHandler.
Le impostazioni con ambito applicazione e le impostazioni predefinite con ambito utente vengono archiviate in un file denominato application.exe.config, creato nella stessa directory del file eseguibile. Le impostazioni di configurazione dell'applicazione sono di sola lettura. I dati utente specifici vengono archiviati in un file denominato user.config, archiviato nella home directory dell'utente. Se i profili mobili sono abilitati, potrebbero esistere due versioni del file di configurazione utente. In tal caso, le voci nella versione mobile hanno la precedenza sulle voci duplicate nel file di configurazione utente locale.
Per altre informazioni sulle impostazioni dell'applicazione, vedere Impostazioni applicazione per Windows Forms.
Costruttori
| LocalFileSettingsProvider() |
Inizializza una nuova istanza della classe LocalFileSettingsProvider. |
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) |
| GetPreviousVersion(SettingsContext, SettingsProperty) |
Restituisce il valore della proprietà delle impostazioni denominata relativa alla versione precedente della stessa applicazione. |
| 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 provider. |
| MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
| Reset(SettingsContext) |
Riconfigura tutte le proprietà delle impostazioni associate all'applicazione specificata sui valori predefiniti. |
| 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) |
| Upgrade(SettingsContext, SettingsPropertyCollection) |
Tenta di eseguire la migrazione delle precedenti impostazioni con ambito di utente da una versione precedente della stessa applicazione. |
