SettingsPropertyValue.PropertyValue Özellik

Tanım

Ad Alanı:

System.Configuration

Bütünleştirilmiş Kod:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Kaynak:

SettingsPropertyValue.cs

Nesnenin SettingsProperty değerini alır veya ayarlar.

public:
 property System::Object ^ PropertyValue { System::Object ^ get(); void set(System::Object ^ value); };

public object PropertyValue { get; set; }

member this.PropertyValue : obj with get, set

Public Property PropertyValue As Object

Özellik Değeri

Object

Nesnesinin SettingsProperty değeri. Bu değer ayarlandığında, IsDirty özelliği olarak ayarlanır true ve UsingDefaultValue olarak ayarlanır false.

Bir değere özelliğinden PropertyValue ilk kez erişildiğinde ve değer ilk olarak özelliği kullanılarak SerializedValue serileştirilmiş bir gösterim olarak nesneye SettingsPropertyValue depolandıysa, PropertyValue özellik temel alınan değerin seri durumdan çıkarıldığını tetikler. Yan etki olarak özelliği Deserialized olarak trueayarlanır.

Bu olay zinciri ASP.NET gerçekleşirse ve seri durumdan çıkarma işlemi sırasında bir hata oluşursa, hata ASP.NET sistem durumu izleme özelliği kullanılarak günlüğe kaydedilir. Varsayılan olarak bu, ASP.NET altında çalışırken seri durumdan çıkarma hatalarının Uygulama Olay Günlüğü'nde gösterileceği anlamına gelir. Bu işlem ASP.NET dışında gerçekleşirse ve seri durumdan çıkarma sırasında bir hata oluşursa, hata bastırılır ve seri durumdan çıkarma sırasında mantığın geri kalanı gerçekleşir. Seri durumdan çıkarma denendiğinde seri durumdan çıkarılacak bir değer yoksa, SettingsPropertyValue ilişkili SettingsProperty örnekte tanımlandığı şekilde yapılandırılmışsa nesne bunun yerine varsayılan bir değer döndürmeyi dener. Bu durumda, özellik olarak veya "[null]" dizesi olarak ayarlandıysa DefaultValuenull, SettingsPropertyValue nesne başvuru türleri için veya ilişkili değer türü için varsayılan değer için özelliğini null başlatırPropertyValue. Öte yandan, özellik geçerli bir nesne başvurusu veya dize değeri ("[null]" dışında) barındırıyorsa DefaultValueDefaultValue , bunun yerine özelliği döndürülür.

Seri durumdan çıkarma denendiğinde seri durumdan çıkarılacak serileştirilmiş bir değer yoksa ve varsayılan değer belirtilmediyse, dize türleri için boş bir dize döndürülür. Diğer tüm türler için çağrılarak CreateInstance(Type) varsayılan bir örnek döndürülür. Başvuru türleri için bu, parametresiz oluşturucu kullanılarak nesne örneği oluşturma girişiminde bulunulacağı anlamına gelir. Bu girişim başarısız olursa döndürülür null .

Özel durumlar

ArgumentException

özelliğinden DefaultValue varsayılan değeri kullanmaya çalışılırken bir hata oluştu. Özelliği geçerli bir türe dönüştürme DefaultValue girişimi başarısız oldu veya sonuçta elde edilen değer tarafından PropertyTypetanımlanan türle uyumlu değildi.