Partager via

Guide pratique pour créer des grilles de propriétés pour les paramètres utilisateur en Visual Basic

  • Article

Vous pouvez créer une grille de propriétés pour les paramètres utilisateur en remplissant un contrôle PropertyGrid avec les propriétés des paramètres utilisateur de l’objet My.Settings.

Notes

Pour que cet exemple fonctionne, les paramètres utilisateur de votre application doivent être configurés. Pour plus d’informations, consultez Gestion des paramètres d’une application (.NET).

L’objet My.Settings expose chaque paramètre en tant que propriété. Le nom de la propriété est le même que le nom du paramètre, et le type de la propriété est le même que le type du paramètre. La portée du paramètre détermine si la propriété est en lecture seule. La propriété d’un paramètre de portée Application est en lecture seule, tandis que la propriété d’un paramètre de portée Utilisateur est en lecture-écriture. Pour plus d’informations, consultez My.Settings, objet.

Notes

Vous ne pouvez pas changer ou enregistrer les valeurs des paramètres de portée application au moment de l’exécution. Les paramètres de portée application peuvent être changés uniquement lors de la création de l’application (par l’intermédiaire du Concepteur de projet) ou en modifiant le fichier de configuration de l’application. Pour plus d’informations, consultez Gestion des paramètres d’une application (.NET).

Cet exemple utilise un contrôle PropertyGrid pour accéder aux propriétés des paramètres utilisateur de l’objet My.Settings. Par défaut, PropertyGrid affiche toutes les propriétés de l’objet My.Settings. Toutefois, les propriétés des paramètres utilisateur ont l’attribut UserScopedSettingAttribute. Cet exemple affecte la valeur UserScopedSettingAttribute à la propriété BrowsableAttributes de PropertyGrid pour afficher uniquement les propriétés des paramètres utilisateur.

Pour ajouter une grille de propriétés de paramètres utilisateur

  1. Faites glisser le contrôle PropertyGrid de la boîte à outils vers l’aire de conception de votre application, que l’on suppose être ici Form1.

    Le nom par défaut du contrôle de grille de propriétés est PropertyGrid1.

  2. Double-cliquez sur l’aire de conception de Form1 pour ouvrir le code du gestionnaire d’événements de chargement de formulaire.

  3. Définissez l’objet My.Settings comme objet sélectionné pour la grille des propriétés.

    PropertyGrid1.SelectedObject = My.Settings

  4. Configurez la grille de propriétés pour afficher uniquement les paramètres utilisateur.

    ' Attribute for the user-scope settings.
Dim userAttr As New System.Configuration.UserScopedSettingAttribute
Dim attrs As New System.ComponentModel.AttributeCollection(userAttr)
PropertyGrid1.BrowsableAttributes = attrs

    Notes

    Pour afficher uniquement les paramètres de portée application, utilisez l’attribut ApplicationScopedSettingAttribute au lieu de UserScopedSettingAttribute.

Programmation fiable

L’application enregistre les paramètres utilisateur quand elle s’arrête. Pour enregistrer les paramètres immédiatement, appelez la méthode My.Settings.Save. Pour plus d’informations, consultez Guide pratique pour rendre persistants les paramètres utilisateur en Visual Basic.

Voir aussi