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)。 這個範例會將 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 中讀取應用程式設定
HOW TO:在 Visual Basic 中變更使用者設定
HOW TO:保存 Visual Basic 中的使用者設定