Comment : créer des grilles de propriétés pour les paramètres utilisateur dans Visual Basic

  • Article

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

Notes

Pour que cet exemple fonctionne, vous devez configurer les paramètres utilisateur de votre application. Pour plus d'informations sur l'ajout de paramètres utilisateur, consultez Comment : ajouter ou supprimer des paramètres d'application.

L'objet My.Settings expose chaque paramètre comme une propriété. Le nom de la propriété et celui du paramètre sont identiques, de même que le type de propriété et le type de 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 mode lecture-écriture. Pour plus d'informations, consultez Objet My.Settings (Visual Basic).

Notes

Vous ne pouvez pas modifier ni enregistrer les valeurs des paramètres de portée application au moment de l'exécution. Les paramètres de portée application ne peuvent être modifiés que lors de la création de l'application (via le Concepteur de projets) ou de la modification du fichier de configuration de l'application. Pour plus d'informations, consultez Gestion des paramètres de l'application.

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, la 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 propriété BrowsableAttributes du PropertyGrid la valeur UserScopedSettingAttribute pour afficher uniquement les propriétés des paramètres utilisateur.

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

  1. Ajoutez le contrôle PropertyGrid de la Boîte à outils à l'aire de conception de votre application, représentée dans cet exemple par Form1.

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

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

  3. Définissez l'objet My.Settings comme étant l'objet sélectionné pour la grille de 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 lorsqu'elle s'arrête. Pour enregistrer les paramètres immédiatement, appelez la méthode My.Settings.Save. Pour plus d'informations, consultez Comment : rendre persistants les paramètres utilisateur dans Visual Basic.

Voir aussi

Tâches

Comment : lire des paramètres d'application dans Visual Basic

Comment : modifier les paramètres utilisateur dans Visual Basic

Comment : rendre persistants les paramètres utilisateur dans Visual Basic

Comment : ajouter ou supprimer des paramètres d'application

Référence

Objet My.Settings (Visual Basic)

Autres ressources

Gestion des paramètres de l'application