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.