SettingsPropertyValue.PropertyValue Özellik

Tanım

Ad Alanı:

System.Configuration

Bütünleştirilmiş Kod:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v11.0.0-preview.5.26302.115

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 özelliği IsDirty olarak ayarlanır true ve UsingDefaultValue olarak ayarlanır false.

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

Bu olay zinciri ASP.NET oluşursa 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örüneceğ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 gizlenirse ve seri durumdan çıkarma sırasında mantığın geri kalanı oluşur. Seri durumdan çıkarma denendiğinde seri durumdan çıkarılacak seri durumdan çıkarılacak bir değer yoksa, SettingsPropertyValue ilişkili SettingsProperty örnekte tanımlandığı şekilde yapılandırıldıysa nesne bunun yerine varsayılan bir değer döndürmeyi dener. Bu durumda, özellik olarak veya "[null]" dizesine ayarlandıysa DefaultValuenull, SettingsPropertyValue nesne başvuru türleri için veya ilişkili değer türü için varsayılan değer olarak özelliğini PropertyValue başlatırnull. Öte yandan, özellik geçerli bir nesne başvurusu veya dize değeri ("[null]" dışında) barındırıyorsa DefaultValue , DefaultValue bunun yerine özelliği döndürülür.

Seri durumdan çıkarma denendiğinde seri durumdan çıkarılacak serileştirilmiş 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 bir nesne örneği oluşturmaya çalışılacağı anlamına gelir. Bu girişim başarısız olursa, null döndürülür.

Ö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.