Aracılığıyla paylaş


SettingsProvider Sınıf

Tanım

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::ProviderBase
public abstract class SettingsProvider : System.Configuration.Provider.ProviderBase
type SettingsProvider = class
    inherit ProviderBase
Public MustInherit Class SettingsProvider
Inherits ProviderBase
Devralma
SettingsProvider
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:

  1. Sağlayıcı özniteliği tarafından belirtilen isteği yerine getirebiliyorsa, bunu yapması gerektiği açıktır.

  2. Sağlayıcı isteği yerine getiremezse sessizce yok saymalıdır.

  3. İ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)

Şunlara uygulanır

Ayrıca bkz.