共用方式為

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

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

備註

為了讓此範例能夠運作，您的應用程式必須設定其用戶設定。 如需詳細資訊，請參閱 管理應用程式設定 （.NET） 。

物件 My.Settings 會將每個設定公開為 屬性。 屬性名稱與設定名稱相同，而屬性類型與設定類型相同。 設定的 範圍決定 屬性是否為唯讀，Application 範圍設定的屬性是唯讀的，而 用戶 範圍設定的屬性則是讀寫。 如需詳細資訊，請參閱 My.Settings 物件。

備註

您無法在執行時間變更或儲存應用程式範圍設定的值。 只有在建立應用程式時（透過 項目設計工具）或編輯應用程式的組態檔，才能變更應用程式範圍設定。 如需詳細資訊，請參閱 管理應用程式設定 （.NET） 。

這個範例會使用 PropertyGrid 控件來存取 對象的使用者設定屬性 My.Settings 。 根據預設，PropertyGrid 會顯示 My.Settings 物件的所有屬性。 不過，用戶設定屬性具有 UserScopedSettingAttribute 屬性。 本範例會將 BrowsableAttributes 的 PropertyGrid 屬性設定為 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 方法。 如需詳細資訊，請參閱 如何：在 Visual Basic 中保存使用者設定。

另請參閱

  • Last updated on