LocalFileSettingsProvider Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit la persistance pour les classes de paramètres d'application.
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- Héritage
- Implémente
Remarques
Les fournisseurs de paramètres définissent un mécanisme de stockage des données de configuration utilisées dans l’architecture des paramètres d’application. Le .NET Framework contient un seul fournisseur de paramètres par défaut, LocalFileSettingsProvider, qui stocke les données de configuration dans le système de fichiers local. Une propriété de paramètres d’application ou un groupe de propriétés sont associés à un fournisseur de paramètres spécifique via l’utilisation SettingsProviderAttributede .
En règle générale, le programme client n’accède pas explicitement à cette classe ; au lieu de cela, l’architecture des paramètres d’application appelle automatiquement le fournisseur de paramètres approprié lorsque ses services sont requis. Par exemple, la plupart des membres de ApplicationSettingsBase déléguer leur travail au fournisseur de paramètres associé.
LocalFileSettingsProvider conserve les paramètres dans les fichiers de configuration qui ont l’extension .config. Le contenu des fichiers de configuration est structuré en tant que documents XML. Selon que le paramètre est défini au niveau de l’application ou de l’utilisateur, les données de configuration sont stockées en tant qu’éléments au sein d’un ou d’un <applicationSettings><userSettings> groupe de sections, respectivement. Chacun de ces groupes de sections est représenté par un correspondant AppSettingsSection ou ClientSettingsSection, respectivement. Chaque objet de section est détenu et administré par un gestionnaire de section de configuration, qui est un objet de type IConfigurationSectionHandler.
Les paramètres d’étendue de l’application et les paramètres par défaut définis par l’utilisateur sont stockés dans un fichier nommé application.exe.config, qui est créé dans le même répertoire que le fichier exécutable. Les paramètres de configuration de l’application sont en lecture seule. Les données utilisateur spécifiques sont stockées dans un fichier nommé user.config, stocké dans le répertoire de base de l’utilisateur. Si les profils d’itinérance sont activés, deux versions du fichier de configuration utilisateur peuvent exister. Dans ce cas, les entrées de la version itinérante sont prioritaires par rapport aux entrées dupliquées dans le fichier de configuration de l’utilisateur local.
Pour plus d’informations sur les paramètres d’application, consultez Paramètres de l’application pour Windows Forms.
Constructeurs
| LocalFileSettingsProvider() |
Initialise une nouvelle instance de la classe LocalFileSettingsProvider. |
Propriétés
| ApplicationName |
Obtient ou définit le nom de l'application en cours d'exécution. |
| Description |
Obtient une description brève et conviviale qui peut s'afficher dans les outils d'administration ou d'autres interfaces utilisateur. (Hérité de ProviderBase) |
| Name |
Obtient le nom convivial qui référence le fournisseur au cours de la configuration. (Hérité de ProviderBase) |
Méthodes
| Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
| GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
| GetPreviousVersion(SettingsContext, SettingsProperty) |
Retourne la valeur de la propriété de paramètres nommée pour la version antérieure de la même application. |
| GetPropertyValues(SettingsContext, SettingsPropertyCollection) |
Retourne la collection de valeurs de propriétés de définition pour l'instance d'application et le groupe de propriétés de paramètres spécifiés. |
| GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
| Initialize(String, NameValueCollection) |
Initialise le fournisseur. |
| MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
| Reset(SettingsContext) |
Restaure les valeurs par défaut de toutes les propriétés de paramètres d'application associées à l'application spécifiée. |
| SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) |
Définit les valeurs du groupe de paramètres de propriétés spécifié. |
| ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
| Upgrade(SettingsContext, SettingsPropertyCollection) |
Tentatives de migrer des paramètres de portée utilisateur antérieurs à partir d'une version antérieure de la même application. |
