Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

DataContractSerializer Constructor (Type^, IEnumerable<Type^>^, Int32, Boolean, Boolean, IDataContractSurrogate^)

 

Initializes a new instance of the DataContractSerializer class to serialize or deserialize an object of the specified type. This method also specifies a list of known types that may be present in the object graph, the maximum number of graph items to serialize, parameters to ignore unexpected data, whether to use non-standard XML constructs to preserve object reference data in the graph, and a surrogate for custom serialization.

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

public:
DataContractSerializer(
	Type^ type,
	IEnumerable<Type^>^ knownTypes,
	int maxItemsInObjectGraph,
	bool ignoreExtensionDataObject,
	bool preserveObjectReferences,
	IDataContractSurrogate^ dataContractSurrogate
)

Parameters

type
Type: System::Type^

The type of the instances that are serialized or deserialized.

knownTypes
Type: System.Collections.Generic::IEnumerable<Type^>^

An IEnumerable<T> of Type that contains the known types that may be present in the object graph.

maxItemsInObjectGraph
Type: System::Int32

The maximum number of items in the graph to serialize or deserialize. The default is the value returned by the MaxValue property.

ignoreExtensionDataObject
Type: System::Boolean

true to ignore the data supplied by an extension of the type upon serialization and deserialization; otherwise, false.

preserveObjectReferences
Type: System::Boolean

true to use non-standard XML constructs to preserve object reference data; otherwise, false.

dataContractSurrogate
Type: System.Runtime.Serialization::IDataContractSurrogate^

An implementation of the IDataContractSurrogate to customize the serialization process.

Exception Condition
ArgumentOutOfRangeException

The number of items exceeds the maximum value.

The following example creates an instance of the DataContractSerializer that specifies the type to serialize or deserialize and an instance of a IEnumerable<T> to contain the known types used during serialization or deserialization. The code also sets the ignoreExtensionDataObject and preserveObjectReferences parameters to true, and specifies an implementation of the IDataContractSurrogate interface to handle legacy types (types that do not have the DataContractAttribute attribute applied). For more information, see the IDataContractSurrogate documentation.

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

.NET Framework
Available since 3.0
Return to top
Show:
© 2017 Microsoft