SettingsPropertyValue.PropertyValue Vlastnost

Definice

Obor názvů:

System.Configuration

Sestavení:

System.Configuration.ConfigurationManager.dll

Balíček:

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

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 . Pokud je tato hodnota nastavena, IsDirty vlastnost je nastavena true a UsingDefaultValue je nastavena na false.

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

Pokud k tomuto řetězci událostí dochází 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 chyby deserializace se při spuštění v ASP.NET zobrazí v protokolu událostí aplikace. Pokud k tomuto procesu dochází mimo ASP.NET a pokud dojde k chybě během deserializace, je chyba potlačena a zbytek logiky během deserializace nastane. Pokud při pokusu o deserializaci neexistuje žádná serializovaná hodnota, SettingsPropertyValue objekt se 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 buď null, nebo na řetězec "[null]", pak SettingsPropertyValue objekt inicializuje PropertyValue vlastnost 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 (jiné než "[null]"), DefaultValue vrátí se místo toho vlastnost.

Pokud při pokusu o deserializaci neexistuje žádná serializovaná hodnota a nebyla zadána žádná výchozí hodnota, vrátí se prázdný řetězec pro typy řetězců. Pro všechny ostatní typy bude vrácena výchozí instance voláním CreateInstance(Type) – pro odkazové typy to znamená, že se pokusí vytvořit instanci objektu pomocí konstruktoru bez parametrů. Pokud se tento pokus nezdaří, null vrátí se.

Výjimky

ArgumentException

Při pokusu DefaultValue o použití výchozí hodnoty z vlastnosti došlo k chybě. Buď pokus o převod DefaultValue vlastnosti na platný typ selhal, nebo výsledná hodnota nebyla kompatibilní s typem definovaným PropertyType.