SettingsPropertyValue.PropertyValue Proprietà

Definizione

Spazio dei nomi:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacchetto:

System.Configuration.ConfigurationManager v8.0.0

Source:

SettingsPropertyValue.cs

Ottiene o imposta il valore dell'oggetto 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

Valore della proprietà

Object

Valore dell'oggetto SettingsProperty. Quando viene impostato questo valore, la proprietà IsDirty viene impostata su true e la proprietà UsingDefaultValue viene impostata su false.

La prima volta che si accede a un valore dalla proprietà PropertyValue e qualora il valore sia stato inizialmente archiviato nell'oggetto SettingsPropertyValue come rappresentazione serializzata utilizzando la proprietà SerializedValue, la proprietà PropertyValue attiverà la deserializzazione del valore sottostante. Come effetto secondario, la proprietà Deserialized verrà impostata su true.

Se questa catena di eventi si verifica in ASP.NET e viene restituito un errore durante il processo di deserializzazione, l'errore viene registrato utilizzando la funzionalità di monitoraggio dell'integrità di ASP.NET. Per impostazione predefinita, ciò significa che gli errori di deserializzazione verranno visualizzati nel log eventi dell'applicazione durante l'esecuzione in ASP.NET. Se questo processo si verifica esternamente ad ASP.NET e viene restituito un errore durante la deserializzazione, l'errore non viene visualizzato e viene eseguita la logica restante durante la deserializzazione. Se non vi sono valori serializzati da deserializzare quando si tenta di eseguire la deserializzazione, l'oggetto SettingsPropertyValue tenterà di restituire un valore predefinito, qualora ne sia stato configurato uno come previsto nell'istanza di SettingsProperty associata. In questo caso, se la proprietà DefaultValue è stata impostata su null o sulla stringa "[null]", l'oggetto SettingsPropertyValue inizializzerà la proprietà PropertyValue su null per i tipi di riferimento o sul valore predefinito per il tipo di valore associato. Se invece la proprietà DefaultValue contiene un riferimento a un oggetto valido o un valore stringa diverso da "[null]", verrà restituita la proprietà DefaultValue.

Se non vi sono valori serializzati da deserializzare quando si tenta di eseguire la deserializzazione e non è stato specificato alcun valore predefinito, verrà restituita una stringa vuota per i tipi di stringa. Per tutti gli altri tipi, verrà restituita un'istanza predefinita chiamando CreateInstance(Type) : per i tipi di riferimento verrà eseguito un tentativo di creare un'istanza di oggetto usando il costruttore senza parametri. Se questo tentativo non riesce, viene restituito null.

Eccezioni

ArgumentException

Durante il tentativo di utilizzare il valore predefinito dalla proprietà DefaultValue, si è verificato un errore. Il tentativo di convertire la proprietà DefaultValue in un tipo valido non è riuscito oppure il valore risultante non era compatibile con il tipo definito da PropertyType.