LocalFileSettingsProvider LocalFileSettingsProvider LocalFileSettingsProvider LocalFileSettingsProvider Class

Definizione

Fornisce la persistenza per le classi di impostazioni dell'applicazione.Provides persistence for application settings classes.

public ref class LocalFileSettingsProvider : System::Configuration::SettingsProvider, System::Configuration::IApplicationSettingsProvider
public class LocalFileSettingsProvider : System.Configuration.SettingsProvider, System.Configuration.IApplicationSettingsProvider
type LocalFileSettingsProvider = class
    inherit SettingsProvider
    interface IApplicationSettingsProvider
Public Class LocalFileSettingsProvider
Inherits SettingsProvider
Implements IApplicationSettingsProvider
Ereditarietà
LocalFileSettingsProviderLocalFileSettingsProviderLocalFileSettingsProviderLocalFileSettingsProvider
Implementazioni

Commenti

I provider di impostazioni definiscono un meccanismo per archiviare i dati di configurazione usati nell'architettura delle impostazioni dell'applicazione.Setting providers define a mechanism for storing configuration data used in the application settings architecture. Contiene un singolo provider di impostazioni predefinite, LocalFileSettingsProvider, che archivia i dati di configurazione nel file system locale. .NET Framework.NET FrameworkThe .NET Framework.NET Framework contains a single default settings provider, LocalFileSettingsProvider, which stores configuration data to the local file system. Una proprietà o un gruppo di proprietà delle impostazioni dell'applicazione è associato a un provider di impostazioni specifico tramite SettingsProviderAttributel'utilizzo di.An application settings property or group of properties are associated to a specific settings provider through the use of the SettingsProviderAttribute.

In genere, il programma client non accede in modo esplicito a questa classe; invece, l'architettura delle impostazioni dell'applicazione richiama automaticamente il provider di impostazioni appropriato quando sono necessari i relativi servizi.Typically, the client program does not explicitly access this class; rather, the application settings architecture automatically invokes the appropriate settings provider when its services are required. Ad esempio, molti dei membri di ApplicationSettingsBase delegano il proprio lavoro al provider di impostazioni associato.For example, many of the members of ApplicationSettingsBase delegate their work to the associated settings provider.

LocalFileSettingsProviderSalva in modo permanente le impostazioni nei file di configurazione .configcon estensione.LocalFileSettingsProvider persists settings to configuration files that have the extension .config. Il contenuto dei file di configurazione è strutturato come documento XML.The contents of configuration files are structured as XML documents. A seconda del fatto che l'impostazione abbia come ambito a livello di applicazione o a livello di utente, i dati di configurazione vengono archiviati come elementi all' <applicationSettings> interno di <userSettings> un gruppo o di una sezione, rispettivamente.Depending on whether the setting is scoped at either the application-level or user-level, the configuration data is stored as elements within an <applicationSettings> or a <userSettings> section group, respectively. Ognuno di questi gruppi di sezioni è rappresentato rispettivamente da AppSettingsSection un ClientSettingsSectionoggetto o corrispondente.Each of these section groups is represented by a corresponding AppSettingsSection or ClientSettingsSection, respectively. Ogni oggetto Section è di proprietà e amministrato da un gestore della sezione di configurazione, che è IConfigurationSectionHandlerun oggetto di tipo.Each section object is owned and administered by a configuration section handler, which is an object of type IConfigurationSectionHandler.

Le impostazioni con ambito di applicazione e le impostazioni con ambito di utente predefinite vengono archiviate in un application.exe.configfile denominato, che viene creato nella stessa directory del file eseguibile.Application-scoped settings and the default user-scoped settings are stored in a file named application.exe.config, which is created in the same directory as the executable file. Le impostazioni di configurazione dell'applicazione sono di sola lettura.Application configuration settings are read-only. I dati utente specifici vengono archiviati in un file user.configdenominato, archiviato nella home directory dell'utente.Specific user data is stored in a file named user.config, stored under the user's home directory. Se sono abilitati i profili di roaming, è possibile che esistano due versioni del file di configurazione dell'utente.If roaming profiles are enabled, two versions of the user configuration file could exist. In tal caso, le voci della versione roaming hanno la precedenza sulle voci duplicate nel file di configurazione dell'utente locale.In such a case, the entries in the roaming version take precedence over duplicated entries in the local user configuration file.

Per ulteriori informazioni sulle impostazioni dell'applicazione, vedere impostazioni dell'applicazione per Windows Forms.For more information about application settings, see Application Settings for Windows Forms.

Costruttori

LocalFileSettingsProvider() LocalFileSettingsProvider() LocalFileSettingsProvider() LocalFileSettingsProvider()

Inizializza una nuova istanza della classe LocalFileSettingsProvider.Initializes a new instance of the LocalFileSettingsProvider class.

Proprietà

ApplicationName ApplicationName ApplicationName ApplicationName

Ottiene o imposta il nome dell'applicazione attualmente in esecuzione.Gets or sets the name of the currently running application.

Description Description Description Description

Ottiene una breve descrizione di facile comprensione che è possibile visualizzare in strumenti di amministrazione o in altre interfacce utente (UI, User Interface).Gets a brief, friendly description suitable for display in administrative tools or other user interfaces (UIs).

(Inherited from ProviderBase)
Name Name Name Name

Ottiene il nome descrittivo utilizzato per fare riferimento al provider durante la configurazione.Gets the friendly name used to refer to the provider during configuration.

(Inherited from ProviderBase)

Metodi

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetPreviousVersion(SettingsContext, SettingsProperty) GetPreviousVersion(SettingsContext, SettingsProperty) GetPreviousVersion(SettingsContext, SettingsProperty) GetPreviousVersion(SettingsContext, SettingsProperty)

Restituisce il valore della proprietà delle impostazioni denominata relativa alla versione precedente della stessa applicazione.Returns the value of the named settings property for the previous version of the same application.

GetPropertyValues(SettingsContext, SettingsPropertyCollection) GetPropertyValues(SettingsContext, SettingsPropertyCollection) GetPropertyValues(SettingsContext, SettingsPropertyCollection) 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.Returns the collection of setting property values for the specified application instance and settings property group.

GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
Initialize(String, NameValueCollection) Initialize(String, NameValueCollection) Initialize(String, NameValueCollection) Initialize(String, NameValueCollection)

Inizializza il provider.Initializes the provider.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
Reset(SettingsContext) Reset(SettingsContext) Reset(SettingsContext) Reset(SettingsContext)

Riconfigura tutte le proprietà delle impostazioni associate all'applicazione specificata sui valori predefiniti.Resets all application settings properties associated with the specified application to their default values.

SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)

Imposta i valori del gruppo specificato di impostazioni delle proprietà.Sets the values of the specified group of property settings.

ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)
Upgrade(SettingsContext, SettingsPropertyCollection) Upgrade(SettingsContext, SettingsPropertyCollection) Upgrade(SettingsContext, SettingsPropertyCollection) Upgrade(SettingsContext, SettingsPropertyCollection)

Tenta di eseguire la migrazione delle precedenti impostazioni con ambito di utente da una versione precedente della stessa applicazione.Attempts to migrate previous user-scoped settings from a previous version of the same application.

Si applica a

Vedi anche