Comment : créer des grilles de propriétés pour les paramètres utilisateur dans Visual Basic
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.
[!REMARQUE]
Pour que cet exemple fonctionne, vous devez configurer les paramètres utilisateur de votre application.Pour plus d’informations, consultez Gestion des paramètres de l'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 My.Settings, objet.
[!REMARQUE]
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
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.
Double-cliquez sur l'aire de conception de Form1 pour ouvrir le code pour le gestionnaire d'événements de chargement du formulaire.
Définissez l'objet My.Settings comme étant l'objet sélectionné pour la grille de propriétés.
PropertyGrid1.SelectedObject = My.SettingsConfigurez 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[!REMARQUE]
Pour afficher uniquement les paramètres de portée application, utilisez l'attribut de ApplicationScopedSettingAttribute au lieu d' 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