This documentation is archived and is not being maintained.

IDataContractSurrogate.GetDeserializedObject Method

During deserialization, returns an object that is a substitute for the specified object.

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

Object GetDeserializedObject(
	Object obj,
	Type targetType


Type: System.Object
The deserialized object to be substituted.
Type: System.Type
The Type that the substituted object should be assigned to.

Return Value

Type: System.Object
The substituted deserialized object. This object must be of a type that is serializable by the DataContractSerializer. For example, it must be marked with the DataContractAttribute attribute or other mechanisms that the serializer recognizes.

In a simple implementation, use an if…then…else control structure to test whether the obj value is of the surrogated type. If so, transform it as necessary and return the substituted object. The substituted object can be a new instance or the same obj instance.

The following example shows an implementation of the GetDeserializedObject method.

public object GetDeserializedObject(Object obj , Type targetType) 
    Console.WriteLine("GetDeserializedObject invoked");
    // This method is called on deserialization.
    // If PersonSurrogated is being deserialized...
    if (obj is PersonSurrogated)
            //... use the XmlSerializer to do the actual deserialization.
            PersonSurrogated ps = (PersonSurrogated)obj;
            XmlSerializer xs = new XmlSerializer(typeof(Person));
            return (Person)xs.Deserialize(new StringReader(ps.xmlData));
        return obj;


.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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