Udostępnij za pośrednictwem

Porady: tworzenie siatki właściwości dla ustawień użytkownika w Visual Basic

Siatkę właściwości dla ustawień użytkownika można utworzyć, wypełniając kontrolkę PropertyGrid właściwościami obiektu My.Settings dotyczącymi ustawień użytkownika.

Uwaga / Notatka

Aby ten przykład działał, aplikacja musi mieć skonfigurowane ustawienia użytkownika. Aby uzyskać więcej informacji, zobacz Zarządzanie ustawieniami aplikacji (.NET).

Obiekt My.Settings uwidacznia każde ustawienie jako właściwość. Nazwa właściwości jest taka sama jak nazwa ustawienia, a typ właściwości jest taki sam jak typ ustawienia. Zakres ustawienia określa, czy właściwość jest tylko do odczytu; właściwość ustawienia zakresu aplikacji jest tylko do odczytu, a właściwość ustawienia zakresu użytkownika jest do odczytu i zapisu. Aby uzyskać więcej informacji, zobacz My.Settings Object (Obiekt My.Settings).

Uwaga / Notatka

Nie można zmienić ani zapisać wartości ustawień zakresu aplikacji w czasie wykonywania. Ustawienia zakresu aplikacji można zmienić tylko podczas tworzenia aplikacji (za pośrednictwem projektanta projektu) lub edytowania pliku konfiguracji aplikacji. Aby uzyskać więcej informacji, zobacz Zarządzanie ustawieniami aplikacji (.NET).

W tym przykładzie kontrolka PropertyGrid jest używana do uzyskania dostępu do właściwości ustawień użytkownika obiektu My.Settings. Domyślnie obiekt PropertyGrid pokazuje wszystkie właściwości My.Settings obiektu. Jednak właściwości ustawienia użytkownika mają UserScopedSettingAttribute atrybut . W tym przykładzie właściwość BrowsableAttributes elementu PropertyGrid jest ustawiona na UserScopedSettingAttribute, aby wyświetlać tylko właściwości ustawień użytkownika.

Aby dodać tabelę właściwości ustawień użytkownika

  1. Dodaj kontrolkę PropertyGrid z Przybornika do powierzchni projektowej aplikacji, przy założeniu, że tutaj znajduje się Form1.

    Domyślną nazwą kontrolki property-grid jest PropertyGrid1.

  2. Kliknij dwukrotnie powierzchnię projektową Form1, aby otworzyć kod programu obsługi zdarzenia ładowania formularza.

  3. My.Settings Ustaw obiekt jako wybrany obiekt dla siatki właściwości.

    PropertyGrid1.SelectedObject = My.Settings

  4. Skonfiguruj siatkę właściwości tak, aby pokazywała tylko ustawienia użytkownika.

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

    Uwaga / Notatka

    Aby wyświetlić tylko ustawienia zakresu aplikacji, użyj atrybutu ApplicationScopedSettingAttribute zamiast UserScopedSettingAttribute.

Niezawodne programowanie

Aplikacja zapisuje ustawienia użytkownika po zamknięciu aplikacji. Aby natychmiast zapisać ustawienia, wywołaj metodę My.Settings.Save . Aby uzyskać więcej informacji, zobacz How to: Persist User Settings in Visual Basic (Jak utrwalać ustawienia użytkownika w Visual Basic).

Zobacz także