SerializationInfo::AddValue Method (String^, UInt32)

 
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.

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)

public:
[CLSCompliantAttribute(false)]
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.

Exception Condition
ArgumentNullException

The name parameter is null.

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
Available since 1.1
Return to top
Show: