SettingsProvider Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Uygulama ayarları mimarisinde özel ayar sağlayıcıları türetilmesi için temel sınıf görevi görür.
public ref class SettingsProvider abstract : System::Configuration::Provider::ProviderBasepublic abstract class SettingsProvider : System.Configuration.Provider.ProviderBasetype SettingsProvider = class
inherit ProviderBasePublic MustInherit Class SettingsProvider
Inherits ProviderBase- Devralma
- Türetilmiş
Açıklamalar
Ayarlar sağlayıcısı, uygulama ayarları mimarisinde kullanılan yapılandırma verilerini depolama mekanizmasını tanımlar. .NET Framework, LocalFileSettingsProvideryapılandırma verilerini yerel dosya sistemine depolayan tek bir varsayılan ayar sağlayıcısı içerir. Ancak soyut SettingsProvider sınıftan türeterek alternatif depolama mekanizmaları oluşturabilirsiniz. Sarmalayıcı sınıfının kullandığı sağlayıcı, sarmalayıcı sınıfı ile SettingsProviderAttributesüslenerek belirlenir. Bu öznitelik sağlanmazsa, varsayılan LocalFileSettingsProviderdeğeri kullanılır.
Özel ayarlar sağlayıcısı oluşturduğunuzda, en azından bu sınıfın üç yöntemi için uygulamalar sağlamanız gerekir: GetPropertyValues, SetPropertyValues ve ApplicationName.
İstemci uygulamaları için, arabirimini de uygulayarak IApplicationSettingsProvider özel bir sağlayıcıya daha standartlaştırılmış işlevsellik ekleyebilirsiniz. Bu arabirim, temelde sürüm oluşturma desteğini etkinleştiren sınıfında bulunan ApplicationSettingsBase yöntemleri yansıtır.
Genellikle, depolama kaynağı çekişmelerini önlemek için ayarlar sağlayıcılarını tek örnekli olacak şekilde tasarlamanız gerekir. Sağlayıcılar aynı anda tek bir uygulama etki alanındaki birden çok sarmalayıcı örneğinden veya farklı etki alanlarındaki birden çok uygulamadan çağrılabileceğinden iş parçacığı açısından da güvenli olmalıdır.
En azından, bir ayar sağlayıcısının üç özniteliği tanıması gerekir: ApplicationScopedSettingAttribute, UserScopedSettingAttributeve DefaultSettingValueAttribute. Uygulama ayarlarına uygulanabilecek özniteliklerin tam listesi için bkz. Uygulama Ayarları Öznitelikleri. Özel ayar sağlayıcısı, ayarlar özelliklerine uygulanan öznitelikleri aşağıdaki şekilde çözümlemelidir:
Sağlayıcı özniteliği tarafından belirtilen isteği yerine getirebiliyorsa, bunu yapması gerektiği açıktır.
Sağlayıcı isteği yerine getiremezse sessizce yok saymalıdır.
İki veya daha fazla özellik çakışırsa; örneğin, hem hem UserScopedSettingAttributede ApplicationScopedSettingAttribute ile süslenen bir özellik; sağlayıcı bir ConfigurationExceptionoluşturmalıdır.
Oluşturucular
| SettingsProvider() |
SettingsProvider sınıfının örneğini başlatır. |
Özellikler
| ApplicationName |
Çalışmakta olan uygulamanın adını alır veya ayarlar. |
| Description |
Yönetim araçlarında veya diğer kullanıcı arabirimlerinde (UI) görüntülenmeye uygun kısa ve kolay bir açıklama alır. (Devralındığı yer: ProviderBase) |
| Name |
Yapılandırma sırasında sağlayıcıya başvurmak için kullanılan kolay adı alır. (Devralındığı yer: ProviderBase) |
Yöntemler
| Equals(Object) |
Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object) |
| GetHashCode() |
Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object) |
| GetPropertyValues(SettingsContext, SettingsPropertyCollection) |
Belirtilen uygulama örneği ve ayarlar özellik grubu için ayarlar özellik değerlerinin koleksiyonunu döndürür. |
| GetType() |
Type Geçerli örneğini alır. (Devralındığı yer: Object) |
| Initialize(String, NameValueCollection) |
Yapılandırma oluşturucusunu başlatır. (Devralındığı yer: ProviderBase) |
| MemberwiseClone() |
Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object) |
| SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) |
Belirtilen özellik ayarları grubunun değerlerini ayarlar. |
| ToString() |
Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object) |
