Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

LocalFileSettingsProvider classe

 

Date de publication : novembre 2016

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

Espace de noms:   System.Configuration
Assembly:  System (dans System.dll)

System.Object
  System.Configuration.Provider.ProviderBase
    System.Configuration.SettingsProvider
      System.Configuration.LocalFileSettingsProvider

[PermissionSetAttribute(SecurityAction.LinkDemand, Name = "FullTrust")]
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public class LocalFileSettingsProvider : SettingsProvider, IApplicationSettingsProvider

NomDescription
System_CAPS_pubmethodLocalFileSettingsProvider()

Initialise une nouvelle instance de la classe LocalFileSettingsProvider.

NomDescription
System_CAPS_pubpropertyApplicationName

Obtient ou définit le nom de l’application en cours d’exécution.(Remplace SettingsProvider.ApplicationName.)

System_CAPS_pubpropertyDescription

Obtient une description brève et conviviale qui peut s’afficher dans les outils d’administration ou d’autres interfaces utilisateur (IU).(Hérité de ProviderBase.)

System_CAPS_pubpropertyName

Obtient le nom convivial utilisé pour faire référence au fournisseur lors de la configuration.(Hérité de ProviderBase.)

NomDescription
System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetPreviousVersion(SettingsContext, SettingsProperty)

Retourne la valeur de la propriété de paramètres nommée pour la version précédente de la même application.

System_CAPS_pubmethodGetPropertyValues(SettingsContext, SettingsPropertyCollection)

Retourne la collection de définition des valeurs de propriété pour le groupe de propriétés instance et les paramètres d’application spécifié.(Remplace SettingsProvider.GetPropertyValues(SettingsContext, SettingsPropertyCollection).)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodInitialize(String, NameValueCollection)

Initialise le fournisseur.(Remplace ProviderBase.Initialize(String, NameValueCollection).)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_pubmethodReset(SettingsContext)

Réinitialise toutes les propriétés de paramètres d’application associées à l’application spécifiée à leurs valeurs par défaut.

System_CAPS_pubmethodSetPropertyValues(SettingsContext, SettingsPropertyValueCollection)

Définit les valeurs du groupe de paramètres de propriété spécifié.(Remplace SettingsProvider.SetPropertyValues(SettingsContext, SettingsPropertyValueCollection).)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodUpgrade(SettingsContext, SettingsPropertyCollection)

Essaie de migrer les paramètres de portée utilisateur antérieurs à partir d’une version précédente de la même application.

Les fournisseurs de paramètres définissent un mécanisme pour stocker les données de configuration utilisées dans l’architecture des paramètres d’application. La .NET Framework contient un fournisseur de paramètres par défaut unique LocalFileSettingsProvider, qui stocke les données de configuration pour le système de fichiers local. Une propriété de paramètres d’application ou d’un groupe de propriétés sont associés à un fournisseur de paramètres spécifiques à l’aide de la 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, la plupart des membres de ApplicationSettingsBase délèguent leur travail au fournisseur de paramètres associé.

LocalFileSettingsProvider rend persistants les paramètres des fichiers de configuration qui ont l’extension .config. Le contenu des fichiers de configuration est structuré comme des documents XML. Selon que le paramètre est portée au niveau de l’application ou utilisateur, les données de configuration sont stockées comme éléments dans un <applicationSettings> ou un <userSettings> section groupe, 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.

Paramètres de portée application et les paramètres de portée utilisateur par défaut sont stockés dans un fichier nommé application.exe.config, qui est créé dans le même répertoire que le fichier exécutable. 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. 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 en double dans le fichier de configuration utilisateur local.

Pour plus d’informations sur les paramètres de l’application, consultez la page Paramètres d'application pour les Windows Forms.

.NET Framework
Disponible depuis 2.0

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: