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 ayarlar sağlayıcılarını türetmek 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, yapılandırma verilerini yerel dosya sistemine depolayan LocalFileSettingsProvider 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 değeri LocalFileSettingsProviderkullanı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şmesi önlemek için ayarlar sağlayıcılarını tek örnekli olacak şekilde tasarlamanız gerekir. Tek bir uygulama etki alanındaki birden çok sarmalayıcı örneğinden veya farklı etki alanlarındaki birden çok uygulamadan aynı anda çağrılabildiğinden sağlayıcılar da iş parçacığı açısından 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, açıkçası bunu yapmalıdır.
Sağlayıcı isteği yerine getiremezse sessizce yok saymalıdır.
İki veya daha fazla özellik çakışırsa; örneğin, hem hem ApplicationScopedSettingAttributede UserScopedSettingAttribute ile süslenen bir özellik; sağlayıcı bir ConfigurationExceptionoluşturmalıdır.
Oluşturucular
| Name | Description |
|---|---|
| SettingsProvider() |
Sınıfının bir örneğini SettingsProvider başlatır. |
Özellikler
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
| 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() |
Geçerli örneğin Type alır. (Devralındığı yer: Object) |
| Initialize(String, NameValueCollection) |
Yapılandırma oluşturucusunu başlatır. (Devralındığı yer: ProviderBase) |
| MemberwiseClone() |
Geçerli Objectbasit 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 bir dize döndürür. (Devralındığı yer: Object) |
