Partager via


Comment : créer des paramètres d'application

Mise à jour : novembre 2007

À l'aide de code managé, vous pouvez créer de nouveaux paramètres d'application et les lier aux propriétés ou aux contrôles de votre formulaire, afin que ces paramètres soient chargés et enregistrés automatiquement au moment de l'exécution.

Dans la procédure suivante, vous créez manuellement une classe wrapper dérivée de ApplicationSettingsBase. Vous ajoutez à cette classe une propriété publiquement accessible pour chaque paramètre d'application que vous souhaitez exposer.

Vous pouvez également exécuter cette procédure avec un minimum de code dans le concepteur Visual Studio.

Pour créer de nouveaux paramètres d'application par programme

  1. Ajoutez une nouvelle classe à votre projet et renommez-la. Pour cette procédure, cette classe est nommée MyUserSettings. Modifiez la définition de classe afin que la classe dérive de ApplicationSettingsBase.

  2. Définissez une propriété sur cette classe wrapper pour chaque paramètre d'application requis et appliquez cette propriété avec ApplicationScopedSettingAttribute ou UserScopedSettingAttribute, selon la portée du paramètre. Pour plus d'informations sur la portée des paramètres, consultez Vue d'ensemble des paramètres d'application. Votre code doit désormais se présenter comme suit :

    Imports System.Configuration
    
    Public Class MyAppSettings
        Inherits ApplicationSettingsBase
        <UserScopedSetting()> _
        <DefaultSettingValue("white")> _
        Public Property BackgroundColor() As Color
            Get
                BackgroundColor = Me("BackgroundColor")
            End Get
    
            Set(ByVal value As Color)
                Me("BackgroundColor") = value
            End Set
        End Property
    End Class
    
    using System;
    using System.Configuration;
    using System.Drawing;
    
    public class MyUserSettings : ApplicationSettingsBase
    {
        [UserScopedSetting()]
        [DefaultSettingValue("white")]
        public Color BackgroundColor
        {
            get
            {
                return ((Color)this["BackgroundColor"]);
            }
            set
            {
                this["BackgroundColor"] = (Color)value;
            }
        }
    }
    
  3. Créez une instance de cette classe wrapper dans votre application. En règle générale, il s'agira d'un membre privé du formulaire principal. Maintenant que vous avez défini votre classe, vous devez la lier à une propriété ; dans ce cas, il s'agit de la propriété BackColor de votre formulaire. Vous pouvez effectuer cette opération dans le gestionnaire d'événements Load de votre formulaire.

    Dim Mus As MyAppSettings
    
    Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
        Mus = New MyAppSettings()
        Mus.BackgroundColor = Color.AliceBlue
        Me.DataBindings.Add(New Binding("BackColor", Mus, "BackgroundColor"))
    End Sub
    
    MyUserSettings mus;
    
    private void Form1_Load(object sender, EventArgs e)
    {
        mus = new MyUserSettings();
        mus.BackgroundColor = Color.AliceBlue;
        this.DataBindings.Add(new Binding("BackColor", mus, "BackgroundColor"));
    }
    
  4. Si vous permettez la modification des paramètres au moment de l'exécution, vous devez enregistrer les paramètres actuels de l'utilisateur sur disque lorsque vous fermez votre formulaire ; sinon, ces modifications sont perdues.

    Private Sub Form1_FormClosing(ByVal sender As Object, ByVal e As System.Windows.Forms.FormClosingEventArgs) Handles Me.FormClosing
        Mus.Save()
    End Sub
    

    Vous avez maintenant créé avec succès un paramètre d'application et vous l'avez lié à la propriété spécifiée.

Sécurité

Le fournisseur de paramètres par défaut, LocalFileSettingsProvider, rend les informations persistantes dans des fichiers de configuration, sous forme de texte brut. Cela limite la sécurité à la sécurité d'accès aux fichiers mise à la disposition de l'utilisateur actuel par le système d'exploitation. La plus grande prudence est donc conseillée pour les informations stockées dans les fichiers de configuration. Par exemple, une utilisation fréquente des paramètres d'application consiste à stocker des chaînes de connexion qui désignent le magasin de données de l'application. Toutefois, pour des raisons de sécurité, ces chaînes ne doivent pas inclure de mots de passe. Pour plus d'informations sur les chaînes de connexion, consultez SpecialSetting.

Voir aussi

Tâches

Comment : valider des paramètres d'application

Concepts

Vue d'ensemble des paramètres d'application

Référence

SpecialSettingAttribute

LocalFileSettingsProvider