Nasıl Yapılır: Visual Basic'te Kullanıcı Ayarları için Özellik Kılavuzu Oluşturma

  • Makale

Bir denetimi nesnenin kullanıcı ayarı özellikleriyle My.Settings doldurarak kullanıcı ayarları için bir PropertyGrid özellik kılavuzu oluşturabilirsiniz.

Not

Bu örneğin çalışması için uygulamanızın kullanıcı ayarlarının yapılandırılmış olması gerekir. Daha fazla bilgi için bkz. Uygulama Ayarlar Yönetme (.NET).

My.Settings nesnesi her ayarı bir özellik olarak kullanıma sunar. Özellik adı ayar adıyla aynıdır ve özellik türü ayar türüyle aynıdır. Ayarın Kapsamı özelliğin salt okunur olup olmadığını belirler; Uygulama kapsamı ayarının özelliği salt okunurken, Kullanıcı kapsamı ayarının özelliği okuma-yazma şeklindedir. Daha fazla bilgi için bkz. My.Ayarlar Nesne.

Not

Çalışma zamanında uygulama kapsamı ayarlarını değiştiremez veya kaydedemezsiniz. Uygulama kapsamı ayarları yalnızca uygulama oluşturulurken (Project Tasarım Aracı aracılığıyla) veya uygulamanın yapılandırma dosyası düzenlenerek değiştirilebilir. Daha fazla bilgi için bkz. Uygulama Ayarlar Yönetme (.NET).

Bu örnekte, nesnenin kullanıcı ayarı özelliklerine My.Settings erişmek için bir PropertyGrid denetim kullanılır. varsayılan olarak, PropertyGrid nesnesinin tüm özelliklerini My.Settings gösterir. Ancak, kullanıcı ayarı özellikleri özniteliğine UserScopedSettingAttribute sahiptir. Bu örnek, öğesinin BrowsableAttributesPropertyGridUserScopedSettingAttribute özelliğini yalnızca kullanıcı ayarı özelliklerini görüntüleyecek şekilde ayarlar.

Kullanıcı ayarı özellik kılavuzu eklemek için

  1. Toolbox'tan PropertyGrid denetimini, burada olduğu Form1varsayılan uygulamanızın tasarım yüzeyine ekleyin.

    Özellik kılavuzu denetiminin varsayılan adıdır PropertyGrid1.

  2. Form yükleme olay işleyicisinin kodunu açmak için Form1 için tasarım yüzeyine çift tıklayın.

  3. My.Settings Nesneyi özellik kılavuzu için seçili nesne olarak ayarlayın.

    PropertyGrid1.SelectedObject = My.Settings

  4. Özellik kılavuzunu yalnızca kullanıcı ayarlarını gösterecek şekilde yapılandırın.

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

    Not

    Yalnızca uygulama kapsamı ayarlarını göstermek için yerine özniteliğini ApplicationScopedSettingAttributeUserScopedSettingAttributekullanın.

Güçlü Programlama

Uygulama kapatıldığında kullanıcı ayarlarını kaydeder. Ayarları hemen kaydetmek için yöntemini çağırın My.Settings.Save . Daha fazla bilgi için bkz. Nasıl yapılır: Visual Basic'te Kullanıcı Ayarlar Kalıcı Hale Getirmek.

Ayrıca bkz.