Export (0) Print
Expand All

SerializationInfo::AddValue Method (String, Object, Type)

Adds a value into the SerializationInfo store, where value is associated with name and is serialized as being of Type type.

Namespace:  System.Runtime.Serialization
Assembly:  mscorlib (in mscorlib.dll)

public:
void AddValue(
	String^ name, 
	Object^ value, 
	Type^ type
)

Parameters

name
Type: System::String

The name to associate with the value, so it can be deserialized later.

value
Type: System::Object

The value to be serialized. Any children of this object will automatically be serialized.

type
Type: System::Type

The Type to associate with the current object. This parameter must always be the type of the object itself or of one of its base classes.

ExceptionCondition
ArgumentNullException

If name or type is nullptr.

SerializationException

A value has already been associated with name.

The assigned type is always the type of the object, or one of its parents.

If two values are added with names that differ only by case, no exception will be thrown, which is not a recommended practice. However, adding two values with the exact same name will cause the SerializationException to be thrown.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft