共用方式為


HOW TO:在 Visual Basic 中建立使用者設定的屬性方格

您可以使用 My.Settings 物件的使用者設定屬性,填入 PropertyGrid 控制項,以建立使用者設定值的屬性方格。

注意事項注意事項

為了讓此範例能夠運作,您的應用程式必須設定它的使用者設定值。如需詳細資訊,請參閱管理應用程式設定

My.Settings 物件將每個設定公開為屬性。 屬性名稱與設定名稱相同,並且屬性型別也與設定型別相同。 此設定的 [範圍] 會判斷屬性是否為 read-only。若 [使用者]-範圍設定的屬性為 read-write,則 [應用程式]-範圍設定的屬性為 read-only。 如需詳細資訊,請參閱My.Settings 物件

注意事項注意事項

在執行階段不可變更或儲存應用程式範圍的設定值。只有在建立應用程式時,或藉由編輯應用程式的組態檔,才能變更應用程式範圍的設定值 (經由 [專案設計工具])。如需詳細資訊,請參閱管理應用程式設定

這個範例會使用 PropertyGrid 控制項,存取 My.Settings 物件的使用者設定屬性。 根據預設,PropertyGrid 會顯示 My.Settings 物件的所有屬性。 不過,使用者設定屬性 (Property) 具有 UserScopedSettingAttribute 屬性 (Attribute)。 這個範例會將 PropertyGridBrowsableAttributes 屬性設定為 UserScopedSettingAttribute,僅顯示使用者設定屬性。

若要加入使用者設定屬性方格

  1. 請在 [工具箱] 中,將 [PropertyGrid] 控制項加入至應用程式的設計介面,此處會假設為 Form1。

    屬性方格控制項的預設名稱為 PropertyGrid1。

  2. 按兩下 Form1 的設計介面,以開啟表單載入事件處理常式的程式碼。

  3. 將 My.Settings 物件設定為屬性方格的選取物件。

    PropertyGrid1.SelectedObject = My.Settings
    
  4. 將屬性方格設定為僅顯示使用者設定。

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

    若只要顯示應用程式範圍的設定,請使用 ApplicationScopedSettingAttribute 屬性而不是 UserScopedSettingAttribute

穩固程式設計

應用程式關閉時,會儲存使用者設定。 若要立即儲存設定值,請呼叫 My.Settings.Save 方法。 如需詳細資訊,請參閱HOW TO:保存 Visual Basic 中的使用者設定

請參閱

工作

HOW TO:在 Visual Basic 中讀取應用程式設定

HOW TO:在 Visual Basic 中變更使用者設定

HOW TO:保存 Visual Basic 中的使用者設定

參考

My.Settings 物件

概念

管理應用程式設定