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

發行項
08/15/2011

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

注意事項
為了讓此範例能夠運作，您的應用程式必須設定它的使用者設定值。如需加入使用者設定值的詳細資訊，請參閱 HOW TO：加入或移除應用程式設定。

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

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

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

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

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

屬性方格控制項的預設名稱為 PropertyGrid1。
按兩下 Form1 的設計介面，以開啟表單載入事件處理常式的程式碼。
將 My.Settings 物件設定為屬性方格的選取物件。
```
PropertyGrid1.SelectedObject = My.Settings
```

將屬性方格設定為僅顯示使用者設定。

' 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 中建立使用者設定的屬性方格

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

穩固程式設計

請參閱

工作

參考

其他資源

其他資源