Partager via

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

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

Remarque

Pour que cet exemple fonctionne, votre application doit avoir ses paramètres utilisateur configurés. Pour plus d’informations, consultez Gestion des paramètres d’application (.NET).

L’objet My.Settings expose chaque paramètre en tant que propriété. Le nom de la propriété est identique au nom du paramètre, et le type de propriété est identique au type de paramètre. L’étendue du paramètre détermine si la propriété est en lecture seule ; la propriété d’un paramètre d’étendue d’application est en lecture seule, tandis que la propriété d’un paramètre d’étendue utilisateur est en lecture-écriture. Pour plus d’informations, consultez l’objet My.Settings.

Remarque

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

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

Pour ajouter une grille de propriétés de réglages 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 property-grid 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 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

    Remarque

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

Programmation robuste

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

Voir aussi

  • Last updated on