SettingsProvider Sınıf

Başvuru

Tanım

Ad Alanı:: System.Configuration

Bütünleştirilmiş Kod:: System.Configuration.ConfigurationManager.dll

Bütünleştirilmiş Kod:: System.dll

Paket:: System.Configuration.ConfigurationManager v6.0.0

Paket:: System.Configuration.ConfigurationManager v7.0.0

Paket:: System.Configuration.ConfigurationManager v8.0.0

Paket:: System.Configuration.ConfigurationManager v9.0.0-preview.2.24128.5

Kaynak:: SettingsProvider.cs

Kaynak:: SettingsProvider.cs

Kaynak:: SettingsProvider.cs

Ö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::ProviderBase

public abstract class SettingsProvider : System.Configuration.Provider.ProviderBase

type SettingsProvider = class
    inherit ProviderBase

Public MustInherit Class SettingsProvider
Inherits ProviderBase

Devralma: Object

ProviderBase
SettingsProvider

Türetilmiş: System.Configuration.LocalFileSettingsProvider

System.Web.ClientServices.Providers.ClientSettingsProvider

System.Web.Profile.ProfileProvider

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)

Şunlara uygulanır