LocalFileSettingsProvider Classe

Définition

Espace de noms:
System.Configuration
Assembly:
System.dll

Fournit la persistance pour les classes de paramètres d’application.

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
Héritage
Object
ProviderBase
SettingsProvider
LocalFileSettingsProvider
Implémente
IApplicationSettingsProvider

Remarques

Les fournisseurs de définition définissent un mécanisme permettant de stocker les données de configuration utilisées dans l’architecture des paramètres d’application. .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 du SettingsProviderAttribute.

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, un grand nombre des membres de ApplicationSettingsBase déléguer leur travail au fournisseur de paramètres associé.

LocalFileSettingsProvider conserve les paramètres des 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 limité 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 <applicationSettings> ou d’un <userSettings> groupe de sections, respectivement. Chacun de ces groupes de sections est représenté par un ou plusieurs groupes correspondants AppSettingsSection , ClientSettingsSectionrespectivement. 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 définis par défaut 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 d’application sont en lecture seule. Les données utilisateur spécifiques sont stockées dans un fichier nommé user.config, stocké sous le répertoire de base de l’utilisateur. Si les profils itinérants 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 sur les entrées dupliquées dans le fichier de configuration utilisateur local.

Pour plus d’informations sur les paramètres d’application, consultez Application Settings for Windows Forms.

Constructeurs

Nom Description
LocalFileSettingsProvider()

Initialise une nouvelle instance de la classe LocalFileSettingsProvider.

Propriétés

Nom Description
ApplicationName

Obtient ou définit le nom de l’application en cours d’exécution.
Description

Obtient une brève description conviviale adaptée à l’affichage dans les outils d’administration ou d’autres interfaces utilisateur (UIs).

(Hérité de ProviderBase)
Name

Obtient le nom convivial utilisé pour faire référence au fournisseur pendant la configuration.

(Hérité de ProviderBase)

Méthodes

Nom Description
Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetPreviousVersion(SettingsContext, SettingsProperty)

Retourne la valeur de la propriété paramètres nommés pour la version précédente de la même application.
GetPropertyValues(SettingsContext, SettingsPropertyCollection)

Retourne la collection de valeurs de propriété de définition pour l’instance d’application et le groupe de propriétés paramètres spécifiés.
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
Initialize(String, NameValueCollection)

Initialise le fournisseur.
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
Reset(SettingsContext)

Réinitialise toutes les propriétés des paramètres d’application associées à l’application spécifiée à leurs valeurs par défaut.
SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)

Définit les valeurs du groupe spécifié de paramètres de propriété.
ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)
Upgrade(SettingsContext, SettingsPropertyCollection)

Tente de migrer les paramètres d’étendue utilisateur précédents à partir d’une version précédente de la même application.

S’applique à

Voir aussi