SettingsPropertyValue.SerializedValue Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets or sets the serialized value of the SettingsProperty object.

Namespace:   System.Configuration
Assembly:  System (in System.dll)

public object SerializedValue {
	[SecurityPermissionAttribute(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.SerializationFormatter)]
	get;
	[SecurityPermissionAttribute(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.SerializationFormatter)]
	set;
}

Property Value

Type: System.Object

The serialized value of a SettingsProperty object.

Exception Condition
ArgumentException

The serialization options for the property indicated the use of a string type converter, but a type converter was not available.

If the SettingsPropertyValue instance detects that the PropertyValue property has changed since the last time the SerializedValue property was called, it will cause PropertyValue property to be converted to its serialized representation. The specific serialization mechanism to be used is defined by the SerializeAs property on the SettingsProperty instance associated with the SettingsPropertyValue instance. The current supported serialization options are to convert the object to a string using a string type converter, serialize using the XmlSerializer, or perform binary serialization.

System_CAPS_noteNote

The underlying serializers may throw exceptions during the serialization process.

The immediate caller code requires the SerializationFormatter permission (one of the permissions available as part of SecurityPermission) to call either the getter or setter for this property. This permission is enforced with a LinkDemand enumeration value.

.NET Framework
Available since 2.0
Return to top
Show: