SettingsPropertyValue.PropertyValue Vlastnost

Definice

Obor názvů:

System.Configuration

Sestavení:

System.Configuration.ConfigurationManager.dll

Balíček:

System.Configuration.ConfigurationManager v8.0.0

Zdroj:

SettingsPropertyValue.cs

Získá nebo nastaví hodnotu objektu SettingsProperty .

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

Hodnota vlastnosti

Object

Hodnota objektu SettingsProperty . Když je tato hodnota nastavená IsDirty , vlastnost se nastaví na true a UsingDefaultValue nastaví se na false.

Při prvním přístupu k hodnotě z PropertyValue vlastnosti a pokud byla hodnota původně uložena do objektu SettingsPropertyValue jako serializovaná reprezentace pomocí SerializedValue vlastnosti, PropertyValue vlastnost aktivuje deserializaci podkladové hodnoty. Jako vedlejší efekt Deserialized se vlastnost nastaví na true.

Pokud k tomuto řetězu událostí dojde v ASP.NET a pokud dojde k chybě během procesu deserializace, chyba se protokoluje pomocí funkce monitorování stavu ASP.NET. Ve výchozím nastavení to znamená, že při spuštění v rámci ASP.NET se v protokolu událostí aplikace zobrazí chyby deserializace. Pokud k tomuto procesu dochází mimo ASP.NET a dojde-li k chybě během deserializace, je chyba potlačena a zbytek logiky dojde během deserializace. Pokud není k dispozici žádná serializovaná hodnota deserializace při pokusu o deserializaci, pak SettingsPropertyValue se objekt místo toho pokusí vrátit výchozí hodnotu, pokud byla nakonfigurována tak, jak je definována v přidružené SettingsProperty instanci. V tomto případě, pokud DefaultValue byla vlastnost nastavena na null, nebo na řetězec "[null]", pak SettingsPropertyValue objekt inicializuje PropertyValue vlastnost na buď null pro odkazové typy, nebo na výchozí hodnotu pro přidružený typ hodnoty. Na druhou stranu, pokud DefaultValue vlastnost obsahuje platný odkaz na objekt nebo řetězcovou hodnotu (jinou než [null]), vrátí DefaultValue se místo toho vlastnost .

Pokud není k dispozici žádná serializovaná hodnota deserializace při pokusu o deserializaci a nebyla zadána žádná výchozí hodnota, bude vrácen prázdný řetězec pro typy řetězců. U všech ostatních typů se výchozí instance vrátí voláním CreateInstance(Type) – pro odkazové typy to znamená, že se provede pokus o vytvoření instance objektu pomocí konstruktoru bez parametrů. Pokud se tento pokus nezdaří, null vrátí se.

Výjimky

ArgumentException

Při pokusu o použití výchozí hodnoty z DefaultValue vlastnosti došlo k chybě. Pokus o převod DefaultValue vlastnosti na platný typ se nezdařil nebo výsledná hodnota nebyla kompatibilní s typem definovaným nástrojem PropertyType.