Aracılığıyla paylaş

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, uygulama ayarları altyapısı tarafından genellikle ayarlar sağlayıcısı olmak üzere çalışma zamanında incelenir ve bunun amacı da, çalışmayı özel sarmalayıcının belirtilen gereksinimlerine uygun hale getirmektir.

Aşağıdaki tabloda, uygulama ayarları sarmalayıcı sınıfına, bu sınıfın tek tek özelliklerine veya her ikisine de uygulanabilecek öznitelikler listelenir. Tanıma göre, userScopedSettingAttributeveya ApplicationScopedSettingAttributetek bir kapsam özniteliğinin her bir ayar özelliğine uygulanması gerekir.

Uyarı

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

Özellik Hedef Açıklama
SettingsProviderAttribute Her ikisi Kalıcılık için kullanılacak ayarlar sağlayıcısının kısa adını belirtir.

Bu öznitelik sağlanmazsa, LocalFileSettingsProvidervarsayılan sağlayıcı varsayılır.
UserScopedSettingAttribute Her ikisi Bir özelliği kullanıcı kapsamlı uygulama ayarı olarak tanımlar.
ApplicationScopedSettingAttribute Her ikisi Bir özelliği uygulama çapında uygulama ayarı olarak tanımlar.
DefaultSettingValueAttribute Mülkiyet Sağlayıcının, bu özellik için önceden tanımlanmış varsayılan değere dönüştürebileceği bir dize belirtir.

LocalFileSettingsProvider bu özniteliği gerektirmez ve zaten kalıcı bir değer varsa bu öznitelik tarafından sağlanan tüm değerleri geçersiz kılar.
SettingsDescriptionAttribute Mülkiyet Özellikle çalışma ve tasarım zamanı araçları tarafından kullanılan belirli bir ayar için açıklayıcı test sağlar.
SettingsGroupNameAttribute Sınıf 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 ayar grubu için açıklayıcı test sağlar.
SettingsManageabilityAttribute Her ikisi Ayarlar grubuna veya özelliğine sağlanması gereken sıfır veya daha fazla yönetilebilirlik hizmetini belirtir. Kullanılabilir hizmetler SettingsManageability numaralandırması tarafından açıklanmıştır.
SpecialSettingAttribute Mülkiyet Bir ayarın, ayar sağlayıcısı tarafından özel işleme öneren, bağlantı dizesi gibi önceden tanımlanmış özel bir kategoriye ait olduğunu gösterir. Bu öznitelik için önceden tanımlanmış kategoriler SpecialSetting numaralandırması tarafından tanımlanır.
SettingsSerializeAsAttribute Her ikisi Ayarlar grubu veya özelliği için tercih edilen serileştirme mekanizmasını belirtir. Kullanılabilir serileştirme mekanizmaları SettingsSerializeAs numaralandırması tarafından tanımlanır.
NoSettingsVersionUpgradeAttribute Mülkiyet Bir ayar sağlayıcısının işaretli özellik için tüm uygulama yükseltme işlevlerini devre dışı bırakması gerektiğini belirtir.

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 ayar özellikleri uygulanabileceğini gösterir. Both özniteliğin her iki düzeyde de uygulanabileceğini gösterir.

Ayrıca bakınız

  • Last updated on