Aracılığıyla paylaş

Uygulama Ayarları Öznitelikleri

  • Makale

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

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, her bir ayarlar özelliğine yalnızca tek bir kapsam özniteliği (UserScopedSettingAttribute veya ApplicationScopedSettingAttribute) uygulanmalıdır.

Dekont

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

Öznitelik Hedef Tanım
SettingsProviderAttribute Her İkisi Kalıcılık için kullanılacak ayarlar 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 Sağlayıcı tarafından bu özellik için sabit kodlanmış varsayılan değere seri durumdan çıkarılabilen bir dize belirtir.

LocalFileSettingsProvider bu özniteliği gerektirmez ve zaten kalıcı bir değer varsa bu öznitelik tarafından sağlanan değerleri 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 Ayarlar grubu için açık bir ad sağlar. Bu öznitelik eksikse sarmalayıcı ApplicationSettingsBase 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 İkisi Ayarlar grubuna veya özelliğine sağlanması gereken sıfır veya daha fazla yönetilebilirlik hizmetini belirtir. Kullanılabilir hizmetler numaralandırması SettingsManageability tarafından açıklanmıştır.
SpecialSettingAttribute Özellik Bir ayarın, ayarlar sağlayıcısı tarafından özel işleme öneren bir bağlantı dizesi gibi önceden tanımlanmış özel bir kategoriye ait olduğunu gösterir. Bu öznitelik için önceden tanımlanmış kategoriler numaralandırma tarafından SpecialSetting tanımlanır.
SettingsSerializeAsAttribute Her İkisi Ayarlar grubu veya özelliği için tercih edilen serileştirme mekanizmasını belirtir. Kullanılabilir serileştirme mekanizmaları numaralandırma tarafından SettingsSerializeAs tanımlanır.
NoSettingsVersionUpgradeAttribute Özellik 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. Özellik , özniteliğin yalnızca ayarlar özelliklerinin uygulanabileceğini gösterir. Her ikisi de özniteliğin her iki düzeyde de uygulanabileceğini gösterir.

Ayrıca bkz.