Delen via

Procedure: Eigenschapsrasters maken voor gebruikersinstellingen in Visual Basic

U kunt een eigenschappenlijst maken voor gebruikersinstellingen door een PropertyGrid besturingselement te vullen met de gebruikersinstellingen van het My.Settings object.

Opmerking

Om dit voorbeeld te laten werken, moet voor uw toepassing de gebruikersinstellingen zijn geconfigureerd. Zie Toepassingsinstellingen beheren (.NET) voor meer informatie.

In My.Settings het object wordt elke instelling als eigenschap weergegeven. De naam van de eigenschap is hetzelfde als de naam van de instelling en het eigenschapstype is hetzelfde als het instellingstype. Het bereik van de instelling bepaalt of de eigenschap alleen-lezen is; de eigenschap voor een toepassingsbereikinstelling heeft het kenmerk Alleen-lezen, terwijl de eigenschap voor een instelling voor gebruikersbereik lezen/schrijven is. Zie My.Settings Object voor meer informatie.

Opmerking

U kunt de waarden van instellingen voor toepassingsbereik tijdens runtime niet wijzigen of opslaan. Instellingen voor toepassingsbereik kunnen alleen worden gewijzigd wanneer u de toepassing maakt (via projectontwerper) of door het configuratiebestand van de toepassing te bewerken. Zie Toepassingsinstellingen beheren (.NET) voor meer informatie.

In dit voorbeeld wordt een PropertyGrid besturingselement gebruikt voor toegang tot de eigenschappen van de gebruikersinstelling van het My.Settings object. PropertyGrid Standaard worden alle eigenschappen van het My.Settings object weergegeven. De eigenschappen van de gebruikersinstelling hebben echter het UserScopedSettingAttribute kenmerk. In dit voorbeeld wordt de BrowsableAttributes eigenschap van de PropertyGrid ingesteld op UserScopedSettingAttribute om alleen de gebruikerinstellingen weer te geven.

Een eigenschapsraster voor gebruikersinstellingen toevoegen

  1. Voeg het Besturingselement PropertyGrid vanuit de Werkset toe aan het ontwerpoppervlak voor uw toepassing, die hier wordt aangenomen.Form1

    De standaardnaam van het eigenschapsrasterbesturingselement is PropertyGrid1.

  2. Dubbelklik op het ontwerpoppervlak voor Form1 om de code voor de eventhandler van het formulier-ladevenement te openen.

  3. Stel het My.Settings object in als het geselecteerde object voor het eigenschappenraster.

    PropertyGrid1.SelectedObject = My.Settings

  4. Configureer het eigenschappenraster om alleen de gebruikersinstellingen weer te geven.

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

    Opmerking

    Als u alleen de instellingen voor het toepassingsbereik wilt weergeven, gebruikt u het ApplicationScopedSettingAttribute kenmerk in plaats van UserScopedSettingAttribute.

Robuuste programmering

De toepassing slaat de gebruikersinstellingen op wanneer de toepassing wordt afgesloten. Als u de instellingen onmiddellijk wilt opslaan, roept u de My.Settings.Save methode aan. Zie Procedure: Gebruikersinstellingen behouden in Visual Basic voor meer informatie.

Zie ook

  • Last updated on