SettingsPropertyValue.PropertyValue Właściwość

Definicja

Przestrzeń nazw:

System.Configuration

Zestaw:

System.Configuration.ConfigurationManager.dll

Pakiet:

System.Configuration.ConfigurationManager v8.0.0

Źródło:

SettingsPropertyValue.cs

Pobiera lub ustawia wartość SettingsProperty obiektu.

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

Wartość właściwości

Object

Wartość SettingsProperty obiektu. Po ustawieniu tej wartości właściwość jest ustawiona IsDirty na true i UsingDefaultValue jest ustawiona na false.

Gdy wartość jest najpierw uzyskiwana z PropertyValue właściwości i jeśli wartość została początkowo zapisana w SettingsPropertyValue obiekcie jako reprezentacja serializowana przy użyciu SerializedValue właściwości, PropertyValue właściwość wyzwoli deserializacji wartości bazowej. Jako efekt Deserialized uboczny właściwość zostanie ustawiona na true.

Jeśli ten łańcuch zdarzeń występuje w ASP.NET, a błąd wystąpi podczas procesu deserializacji, błąd jest rejestrowany przy użyciu funkcji monitorowania kondycji ASP.NET. Domyślnie oznacza to, że błędy deserializacji będą wyświetlane w dzienniku zdarzeń aplikacji podczas uruchamiania w ASP.NET. Jeśli ten proces występuje poza ASP.NET, a jeśli podczas deserializacji wystąpi błąd, błąd zostanie pominięty, a pozostała część logiki podczas deserializacji wystąpi. Jeśli nie ma wartości serializowanej do deserializacji podczas próby deserializacji, SettingsPropertyValue obiekt zamiast tego podejmie próbę zwrócenia wartości domyślnej, jeśli została skonfigurowana zgodnie z definicją w skojarzonym SettingsProperty wystąpieniu. W takim przypadku, jeśli DefaultValue właściwość została ustawiona na null, lub na ciąg "[null]", SettingsPropertyValue obiekt zainicjuje PropertyValue właściwość dla null typów odwołań lub wartość domyślną skojarzonego typu wartości. Z drugiej strony, jeśli DefaultValue właściwość zawiera prawidłowe odwołanie do obiektu lub wartość ciągu (inną niż "[null]"), DefaultValue właściwość jest zwracana zamiast tego.

Jeśli nie ma wartości serializowanej do deserializacji podczas próby deserializacji i nie określono wartości domyślnej, pusty ciąg zostanie zwrócony dla typów ciągów. W przypadku wszystkich innych typów wystąpienie domyślne zostanie zwrócone przez wywołanie wywołania CreateInstance(Type) — dla typów referencyjnych oznacza to, że zostanie podjęta próba utworzenia wystąpienia obiektu przy użyciu konstruktora bez parametrów. Jeśli ta próba nie powiedzie się, null zostanie zwrócona.

Wyjątki

ArgumentException

Podczas próby użycia wartości domyślnej DefaultValue z właściwości wystąpił błąd. Próba przekonwertowania DefaultValue właściwości na prawidłowy typ nie powiodła się lub wynikowa wartość nie była zgodna z typem zdefiniowanym przez PropertyTypeprogram .