Comment : créer des paramètres d'application à l'aide du concepteur

À l'aide de Visual Studio, 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 configurez les paramètres d'application et les liaisons à l'aide de l'Éditeur de propriétés Windows Forms Lorsque vous utilisez cet éditeur, Visual Studio génère une classe wrapper qui dérive de ApplicationSettingsBase et expose tous vos paramètres en tant que propriétés définies dans cette classe wrapper. Dans la deuxième procédure, vous définissez manuellement cette classe wrapper.

Notes

Les utilisateurs de Visual Studio 2005 peuvent ajouter des paramètres à leur application à l'aide du Concepteur de projets en ajoutant un fichier .settings à leurs applications.En Visual Basic, cela exposera tous les paramètres dans l'objet My.Settings ; d'autres langages généreront une classe Settings exposant ces paramètres.Vous pouvez créer un fichier .settings dans Visual Studio en utilisant l'onglet Paramètres du Concepteur de projets pour créer les paramètres du projet.

Dans Microsoft Visual Basic 2005, le Concepteur de projets contient plus d'options utilisant les paramètres d'application que les autres langages dans Microsoft Visual Studio 2005. Pour plus d'informations, consultez Managing Application Settings.

Notes

Les boîtes de dialogue et les commandes de menu qui s'affichent peuvent être différentes de celles qui sont décrites dans l'aide, en fonction de vos paramètres actifs ou de l'édition utilisée.Pour modifier vos paramètres, choisissez Importation et exportation de paramètres dans le menu Outils.Pour plus d'informations, consultez Paramètres Visual Studio.

Pour créer de nouveaux paramètres de l'application à l'aide de Visual Studio

  1. Sélectionnez le formulaire ou le contrôle dont vous souhaitez lier les propriétés au nouveau paramètre de l'application.

  2. Dans l'Éditeur de propriétés, développez l'élément (Paramètres de l'application), puis cliquez sur le bouton de sélection situé en regard de l'élément (PropertyBindings) au-dessous.

  3. Dans la boîte de dialogue Paramètres de l'application, cliquez sur le menu déroulant pour la propriété que vous souhaitez lier et sélectionnez la commande Nouveau.

    Important

    Le Concepteur n'affichera pas les propriétés dont le type est défini dans l'assembly actuel.Il s'agit d'une limitation connue.Pour effectuer une liaison à cette propriété, exécutez l'une des étapes suivantes :

    • Déplacez la définition du type de propriété vers un autre projet, créez le projet, puis ajoutez au projet actuel une référence à ce nouvel assembly. La propriété doit alors être répertoriée dans la boîte de dialogue Paramètres de l'application.

      ou

    • Au lieu d'utiliser le Concepteur, créez le paramètre d'application par programme. Pour plus d'informations sur cette option, consultez Comment : créer des paramètres d'application.

  4. Dans la boîte de dialogue Nouveau paramètre d'application, configurez le paramètre en lui attribuant un nom et une valeur par défaut (le cas échéant), et en définissant sa portée. Si vous définissez la portée en tant qu'Application, la propriété sera globale et concernera tous les utilisateurs de l'application, mais ne sera vraisemblablement pas modifiable au moment de l'exécution. Si vous définissez la portée en tant qu'Utilisateur, la propriété sera en lecture/écriture et sa valeur sera peut-être différente selon les utilisateurs. Pour plus d'informations sur la portée des paramètres, consultez Vue d'ensemble des paramètres d'application.

  5. Si votre paramètre contient une chaîne de connexion, activez la case à cocher Chaîne de connexion dans la boîte de dialogue.

  6. Cliquez sur OK dans la boîte de dialogue Nouveau paramètre d'application et dans la boîte de dialogue Paramètres de l'application. Vous avez maintenant créé avec succès un nouveau paramètre d'application et vous l'avez lié à la propriété spécifiée.

  7. Pour manipuler des paramètres d'application individuels, accédez aux propriétés de l'objet My.Settings dans Visual Basic, ou de l'objet Settings dans d'autres langages. Par exemple, vous devez appeler explicitement la méthode Save de cette classe wrapper pour faire persister les paramètres utilisateur dans des langages autres que Visual Basic. Cela s'effectue habituellement dans le gestionnaire d'événements Closing du formulaire principal. En Visual Basic, le concepteur génère automatiquement le code pour enregistrer les valeurs actuelles de tous les paramètres utilisateur pendant l'arrêt de l'application.

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 : créer des paramètres d'application

Comment : valider des paramètres d'application

Référence

LocalFileSettingsProvider

Concepts

Vue d'ensemble des paramètres d'application