LocalFileSettingsProvider.SetPropertyValues Yöntem

Tanım

Ad Alanı:

System.Configuration

Bütünleştirilmiş Kod:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v9.0.0-preview.5.24306.7

Kaynak:

LocalFileSettingsProvider.cs

Belirtilen özellik ayarları grubunun değerlerini ayarlar.

public:
 override void SetPropertyValues(System::Configuration::SettingsContext ^ context, System::Configuration::SettingsPropertyValueCollection ^ values);

public override void SetPropertyValues (System.Configuration.SettingsContext context, System.Configuration.SettingsPropertyValueCollection values);

override this.SetPropertyValues : System.Configuration.SettingsContext * System.Configuration.SettingsPropertyValueCollection -> unit

Public Overrides Sub SetPropertyValues (context As SettingsContext, values As SettingsPropertyValueCollection)

Parametreler

context

SettingsContext

SettingsContext Geçerli uygulama kullanımını açıklayan.

values

SettingsPropertyValueCollection

SettingsPropertyValueCollection Ayarlanacağı özellik ayarları grubunu temsil eden.

Özel durumlar

ConfigurationErrorsException

Kullanıcı kapsamlı bir ayarla karşılaşıldı, ancak geçerli yapılandırma yalnızca uygulama kapsamlı ayarları destekliyor.

-veya-

Ayarları yapılandırma dosyasına kaydederken genel bir hata oluştu.

Açıklamalar

öğesinden ApplicationSettingsBasetüretilen bir ayar sarmalayıcı sınıfı, tüm ayar özelliklerinin değerlerini kalıcı hale getirmek için çağrılan yöntemini içerir Save . Bu yöntem, kendi ayarları özellikleriyle ilişkili tüm ayar sağlayıcılarını numaralandırır ve gerçek serileştirme işlemini gerçekleştirmek için her SettingsProvider birinin yöntemini çağırırSetPropertyValues.

SetPropertyValues her kullanıcı kapsamlı uygulama ayarları özelliğini uygun user.config yapılandırma dosyasındaki ilgili uygulama ayarına göre ayrı ayrı serileştirir.

Varsayılan olarak, SetPropertyValues yöntemi ayarlar özelliğinin türüne bağlı olarak seri hale getirme düzenini belirlemek için aşağıdaki mantıksal diziyi kullanır:

1. Türün bir yöntem uygulamasıyla ilişkilendirilmişse TypeConverterConvertToString , bu dönüştürme kullanılır.

2. XML serileştirme kullanılır.

Ancak, kullanarak SettingsSerializeAsAttributetercih edilen bir serileştirme mekanizması belirtebilirsiniz. LocalFileSettingsProvider Visual Studio 2005'te ikili serileştirmeyi desteklemez.

Kullanıcı kapsamlı ayarlar özelliği açıkça varsayılan değerine geri ayarlanırsa, yerel dosya ayarları sağlayıcısı kullanıcı yapılandırma dosyasından ilişkili ayarın girdisini kaldırır. Bu özellik için bir sonraki okuma erişiminde varsayılan değer kullanılır.

Dikkat

LocalFileSettingsProvider herhangi bir ayarı kalıcı hale getirmek için şifreleme kullanmaz. Bu nedenle, yapılandırma dosyasındaki bilgileri ayrı olarak şifreleme gibi ek önlemler almadan bu sağlayıcıyı kullanarak düz metin parolaları veya diğer hassas bilgileri depolamayın. Daha fazla bilgi için bkz. Korumalı Yapılandırma Kullanarak Yapılandırma Bilgilerini Şifreleme.

Ayrıca bkz.

• GetPropertyValues(SettingsContext, SettingsPropertyCollection)
• Save()
• TypeConverter
• SettingsSerializeAsAttribute