Delen via

Procedure: Eigenschapsrasters maken voor gebruikers Instellingen in Visual Basic

  • Artikel

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

Notitie

Om dit voorbeeld te laten werken, moet voor uw toepassing de gebruikersinstellingen zijn geconfigureerd. Zie Toepassingsbeheer Instellingen (.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 instelling voor toepassingsbereik heeft het kenmerk Alleen-lezen, terwijl de eigenschap voor een instelling voor gebruikersbereik lezen/schrijven is. Zie Mijn.Instellingen voor meer informatie Object.

Notitie

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 Toepassingsbeheer Instellingen (.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 eigenschap ingesteld om alleen de eigenschappen van de gebruiker weer te UserScopedSettingAttribute 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 het openen van de code voor de gebeurtenis-handler voor het laden van formulieren.

  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

    Notitie

    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: Gebruikers Instellingen behouden in Visual Basic voor meer informatie.

Zie ook