Uygulama Ayarları Öznitelikleri

uygulama Ayarlar mimarisi, uygulama ayarları sarmalayıcı sınıfına veya tek tek özelliklerine uygulanabilen birçok öznitelik sağlar. Bu öznitelikler, çalışma zamanında uygulama ayarları altyapısı, genellikle özellikle ayar sağlayıcısı tarafından, çalışmasını özel sarmalayıcının belirtilen ihtiyaçlarına göre uyarlamak için bir şekilde incelenir.

Aşağıdaki tablo, uygulama ayarları sarmalayıcı sınıfına, bu sınıfın tek tek özelliklerine veya her ikisine de uygulanabilen öznitelikleri listeler. Tanım olarak, her bir ve her ayar özelliğine yalnızca tek bir kapsam özniteliği (UserScopedSettingAttribute veya ApplicationScopedSettingAttribute) uygulanmalıdır.

Not

Sınıfından türetilen özel bir ayar sağlayıcısı SettingsProvider yalnızca şu üç özniteliği tanımak için gereklidir: SettingsProvider, UserScopedSettingAttributeve DefaultSettingValueAttribute.

Öznitelik Hedef Açıklama
SettingsProviderAttribute Her İkisi Kalıcılık için kullanılacak ayar sağlayıcısının kısa adını belirtir.

Bu öznitelik sağlanmazsa, varsayılan sağlayıcı LocalFileSettingsProvider varsayılır.
UserScopedSettingAttribute Her İkisi Bir özelliği kullanıcı kapsamlı uygulama ayarı olarak tanımlar.
ApplicationScopedSettingAttribute Her İkisi Bir özelliği uygulama kapsamlı uygulama ayarı olarak tanımlar.
DefaultSettingValueAttribute Özellik Bu özellik için sabit kodlanmış varsayılan değere sağlayıcı tarafından seri durumdan çıkarılacak bir dize belirtir.

LocalFileSettingsProviderBu özniteliği gerektirmez ve zaten kalıcı bir değer varsa bu öznitelik tarafından belirtilen değeri geçersiz kılar.
SettingsDescriptionAttribute Özellik Öncelikle çalışma zamanı ve tasarım zamanı araçları tarafından kullanılan tek bir ayar için açıklayıcı test sağlar.
SettingsGroupNameAttribute Sınıf Bir ayarlar grubu için açık bir ad sağlar. Bu öznitelik eksikse, ApplicationSettingsBase sarmalayıcı sınıf adını kullanır.
SettingsGroupDescriptionAttribute Sınıf Öncelikle çalışma zamanı ve tasarım zamanı araçları tarafından kullanılan bir ayarlar grubu için açıklayıcı test sağlar.
SettingsManageabilityAttribute Her İkisi Ayarlar grubuna veya özelliğine sağlanması gereken sıfır veya daha fazla yönetilebilirlik hizmeti belirtir. Kullanılabilir hizmetler, sabit listesi tarafından açıklanmıştır SettingsManageability .
SpecialSettingAttribute Özellik Bir ayarın özel, önceden tanımlanmış bir kategoriye (örneğin, bir bağlantı dizesi) ait olduğunu belirtir. Bu, ayarlar sağlayıcısı tarafından özel işlem önerisinde bulunur. Bu öznitelik için önceden tanımlanmış kategoriler, SpecialSetting sabit listesi tarafından tanımlanır.
SettingsSerializeAsAttribute Her İkisi Bir ayarlar grubu veya özelliği için tercih edilen bir serileştirme mekanizmasını belirtir. Kullanılabilir serileştirme mekanizmaları Listeleme tarafından tanımlanır SettingsSerializeAs .
NoSettingsVersionUpgradeAttribute Özellik Bir ayar sağlayıcısının, işaretlenmiş özellik için tüm uygulama yükseltme işlevlerini devre dışı bırakabilmelidir.

Sınıf , özniteliğin yalnızca bir uygulama ayarları sarmalayıcı sınıfına uygulanabileceğini gösterir. Özelliği , özniteliğin yalnızca ayarlar özellikleri uygulanabileceğini gösterir. Her Ikisi de özniteliğin her Iki düzeyde de uygulanabileceğini gösterir.

Ayrıca bkz.