ObjectManager.RegisterObject Method (Object, Int64, SerializationInfo)

 
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.

Registers an object as it is deserialized, associating it with objectID, and recording the SerializationInfo used with it.

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

[SecurityCriticalAttribute]
public void RegisterObject(
	object obj,
	long objectID,
	SerializationInfo info
)

Parameters

obj
Type: System.Object

The object to register.

objectID
Type: System.Int64

The ID of the object to register.

info
Type: System.Runtime.Serialization.SerializationInfo

The SerializationInfo used if obj implements ISerializable or has a ISerializationSurrogate. info will be completed with any required fixup information and then passed to the required object when that object is completed.

Exception Condition
ArgumentNullException

The obj parameter is null.

ArgumentOutOfRangeException

The objectID parameter is less than or equal to zero.

SerializationException

The objectID has already been registered for an object other than obj.

ObjectManager retains the information about both the object and its ID. Later during deserialization, you can use GetObject to discover whether a particular object ID has already been deserialized, or if it is a forward reference to an object that has not yet been deserialized.

.NET Framework
Available since 1.1
Return to top
Show: