SettingsPropertyValue.PropertyValue Propriété

Définition

Obtient ou définit la valeur de l’objet 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

Valeur de propriété

Valeur de l'objet SettingsProperty. Lorsque cette valeur est définie, la propriété IsDirty a la valeur true et la propriété UsingDefaultValue a la valeur false.

Lorsqu'une valeur fait d'abord l'objet d'un accès à partir de la propriété PropertyValue et qu'elle a été stockée initialement dans l'objet SettingsPropertyValue comme une représentation sérialisée à l'aide de la propriété SerializedValue, la propriété PropertyValue déclenche la désérialisation de la valeur sous-jacente. Comme effet secondaire, la propriété Deserialized aura la valeur true.

Si cette chaîne d'événements se produit dans ASP.NET, et si une erreur se produit pendant le processus de désérialisation, l'erreur est enregistrée à l'aide de la fonctionnalité de contrôle d'intégrité d'ASP.NET. Par défaut, cela signifie que les erreurs de désérialisation apparaîtront dans le Journal des événements de l'application lors de l'exécution sous ASP.NET. Si ce processus se produit en dehors d'ASP.NET, et si une erreur se produit pendant la désérialisation, l'erreur est supprimée, et le reste de la logique pendant la désérialisation se produit. S'il n'existe aucune valeur sérialisée à désérialiser lorsque la désérialisation est tentée, l'objet SettingsPropertyValue tente de retourner une valeur par défaut s'il en existe une qui a été configurée comme définie sur l'instance de SettingsProperty associée. Dans ce cas, si la propriété DefaultValue a pour valeur null ou la chaîne "[null]", l'objet SettingsPropertyValue affecte à la propriété PropertyValue la valeur null pour les types référence ou la valeur par défaut pour le type valeur associé. En revanche, si la propriété DefaultValue a une référence d'objet ou une valeur de chaîne (autre que "[null]") valides, la propriété retournée est DefaultValue.

S'il n'existe aucune valeur sérialisée à désérialiser lorsque la désérialisation est tentée et qu'aucune valeur par défaut n'a été spécifiée, une chaîne vide est retournée pour les types de chaînes. Pour tous les autres types, une instance par défaut est retournée en appelant CreateInstance(Type) . Pour les types de référence, cela signifie qu’une tentative de création d’un objet instance à l’aide du constructeur sans paramètre sera effectuée. Si cette tentative échoue, la valeur null est retournée.

Exceptions

Lors de la tentative d'utilisation de la valeur par défaut de la propriété DefaultValue, une erreur s'est produite. Soit la tentative de conversion de la propriété DefaultValue en type valide a échoué, soit la valeur résultante n'était pas compatible avec le type défini par PropertyType.

S’applique à