Export (0) Print
Expand All

SerializationInfo::AddValue Method (String, UInt32)

Adds a 32-bit unsigned integer value into the SerializationInfo store.

This API is not CLS-compliant. 

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

[CLSCompliantAttribute(false)]
public:
void AddValue(
	String^ name, 
	unsigned int value
)

Parameters

name
Type: System::String

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

value
Type: System::UInt32

The UInt32 value to serialize.

ExceptionCondition
ArgumentNullException

The name parameter is nullptr.

SerializationException

A value has already been associated with name.

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.

The following example uses the AddValue method to customize the serialization of a type. The code adds a string and an integer to an instance of the SerializationInfo class in the GetObjectData method of the ISerializable interface. The code also uses the GetValue method to retrieve values from the SerializationInfo.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4.5.2, 4.5.1, 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