SettingsPropertyValue.PropertyValue Eigenschaft

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Quelle:

SettingsPropertyValue.cs

Ruft den Wert eines SettingsProperty-Objekts ab oder legt ihn fest

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

Eigenschaftswert

Object

Der Wert des SettingsProperty-Objekts. Wurde dieser Wert festgelegt, werden die IsDirty-Eigenschaft auf true und UsingDefaultValue auf false festgelegt.

Wenn der erste Zugriff auf einen Wert über die PropertyValue-Eigenschaft erfolgt und der Wert anfänglich mithilfe der SettingsPropertyValue-Eigenschaft als serialisierte Darstellung im SerializedValue-Objekt gespeichert wurde, löst die PropertyValue-Eigenschaft die Deserialisierung des zugrunde liegenden Wertes aus. Als Nebeneffekt wird die Deserialized-Eigenschaft auf true festgelegt.

Wenn diese Kette von Ereignissen in ASP.NET auftritt, und wenn ein Fehler während des Deserialisierungsprozesses auftritt, wird der Fehler mit der Systemüberwachungsfunktion von ASP.NET protokolliert. Standardmäßig bedeutet dies, dass Deserialisierungsfehler bei der Ausführung unter ASP.NET im Anwendungsereignisprotokoll angezeigt werden. Wenn dieser Prozess außerhalb von ASP.NET auftritt, und wenn ein Fehler während der Deserialisierung auftritt, wird der Fehler unterdrückt und der Rest der Deserialisierungslogik ausgeführt. Wenn beim Versuch der Deserialisierung kein serialisierter Wert vorhanden ist, der deserialisiert werden soll, versucht das SettingsPropertyValue-Objekt stattdessen, einen ggf. laut Definition für die zugeordnete SettingsProperty-Instanz konfigurierten Standardwert zurückzugeben. Wenn die DefaultValue-Eigenschaft auf null oder auf die Zeichenfolge "[null]" festgelegt wurde, initialisiert das SettingsPropertyValue-Objekt in diesem Fall die PropertyValue-Eigenschaft mit null für Referenztypen oder mit dem Standardwert für den zugehörigen Werttyp. Wenn die DefaultValue-Eigenschaft hingegen einen gültigen Objektverweis oder Zeichenfolgenwert (außer "[null]") enthält, wird stattdessen die DefaultValue-Eigenschaft zurückgegeben.

Wenn beim Versuch der Deserialisierung kein serialisierter Wert vorhanden ist, der deserialisiert werden soll, und kein Standardwert angegeben wurde, wird für Zeichenfolgentypen eine leere Zeichenfolge zurückgegeben. Für alle anderen Typen wird ein Standard-instance durch Aufrufen CreateInstance(Type) zurückgegeben. Für Verweistypen bedeutet dies, dass versucht wird, ein Objekt instance mithilfe des parameterlosen Konstruktors zu erstellen. Wenn dieser Versuch fehlschlägt, wird null zurückgegeben.

Ausnahmen

ArgumentException

Beim Versuch, den Standardwert der DefaultValue-Eigenschaft zu verwenden, ist ein Fehler aufgetreten. Entweder ist der Versuch fehlgeschlagen, die DefaultValue-Eigenschaft in einen gültigen Typen zu konvertieren, oder der resultierende Wert war nicht mit dem von PropertyType definierten Typ kompatibel.