CodeDomComponentSerializationService.DeserializeTo Method

Reference

Definition

Namespace:: System.ComponentModel.Design.Serialization

Assembly:: System.Design.dll

Assembly:: System.Windows.Forms.Design.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Deserializes the given SerializationStore to the given container, optionally applying default property values.

public:
 override void DeserializeTo(System::ComponentModel::Design::Serialization::SerializationStore ^ store, System::ComponentModel::IContainer ^ container, bool validateRecycledTypes, bool applyDefaults);

public override void DeserializeTo (System.ComponentModel.Design.Serialization.SerializationStore store, System.ComponentModel.IContainer container, bool validateRecycledTypes, bool applyDefaults);

override this.DeserializeTo : System.ComponentModel.Design.Serialization.SerializationStore * System.ComponentModel.IContainer * bool * bool -> unit

Public Overrides Sub DeserializeTo (store As SerializationStore, container As IContainer, validateRecycledTypes As Boolean, applyDefaults As Boolean)

Parameters

store: SerializationStore

The SerializationStore from which the objects will be deserialized.

container: IContainer

A container of objects to which data will be applied.

validateRecycledTypes: Boolean

true to validate the recycled type; otherwise, false.

applyDefaults: Boolean

true to apply default property values; otherwise, false.

Exceptions

ArgumentNullException

store or container is null.

InvalidOperationException

store is not a supported type of serialization store. Use a store returned by CreateStore().

Remarks

The DeserializeTo method deserializes the given store, but rather than producing new objects, the data in the store is applied to an existing set of objects that are taken from the container parameter. As a result, the caller can create in advance an object however it sees fit. If an object has deserialization state and the object is not named in the set of existing objects, a new object will be created. If that object also implements IComponent, it will be added to the given container. Objects in the container must have names and types that match objects in the serialization store in order for an existing object to be used.

Applies to