SettingsPropertyValue.PropertyValue Proprietà

Definizione

Ottiene o imposta il valore dell'oggetto SettingsProperty.Gets or sets the value of the SettingsProperty object.

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.The value of the SettingsProperty object. Quando viene impostato questo valore, la proprietà IsDirty viene impostata su true e la proprietà UsingDefaultValue viene impostata su false.When this value is set, the IsDirty property is set to true and UsingDefaultValue is set to 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.When a value is first accessed from the PropertyValue property, and if the value was initially stored into the SettingsPropertyValue object as a serialized representation using the SerializedValue property, the PropertyValue property will trigger deserialization of the underlying value. Come effetto secondario, la proprietà Deserialized verrà impostata su true.As a side effect, the Deserialized property will be set to 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.If this chain of events occurs in ASP.NET, and if an error occurs during the deserialization process, the error is logged using the health-monitoring feature of 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.By default, this means that deserialization errors will show up in the Application Event Log when running under 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.If this process occurs outside of ASP.NET, and if an error occurs during deserialization, the error is suppressed, and the remainder of the logic during deserialization occurs. 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.If there is no serialized value to deserialize when the deserialization is attempted, then SettingsPropertyValue object will instead attempt to return a default value if one was configured as defined on the associated SettingsProperty instance. 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.In this case, if the DefaultValue property was set to either null, or to the string "[null]", then the SettingsPropertyValue object will initialize the PropertyValue property to either null for reference types, or to the default value for the associated value type. Se invece la proprietà DefaultValue contiene un riferimento a un oggetto valido o un valore stringa diverso da "[null]", verrà restituita la proprietà DefaultValue.On the other hand, if DefaultValue property holds a valid object reference or string value (other than "[null]"), then the DefaultValue property is returned instead.

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.If there is no serialized value to deserialize when the deserialization is attempted, and no default value was specified, then an empty string will be returned for string types. Per tutti gli altri tipi, viene restituita un'istanza predefinita chiamando CreateInstance(Type) per i tipi di riferimento. questo significa che verrà effettuato un tentativo di creare un'istanza dell'oggetto utilizzando il costruttore senza parametri.For all other types, a default instance will be returned by calling CreateInstance(Type) - for reference types this means an attempt will be made to create an object instance using the parameterless constructor. Se questo tentativo non riesce, viene restituito null.If this attempt fails, then null is returned.

Eccezioni

Durante il tentativo di utilizzare il valore predefinito dalla proprietà DefaultValue, si è verificato un errore.While attempting to use the default value from the DefaultValue property, an error occurred. 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.Either the attempt to convert DefaultValue property to a valid type failed, or the resulting value was not compatible with the type defined by PropertyType.

Si applica a