Edit

Share via


ComponentSerializationService.DeserializeTo Method

Definition

Deserializes the given SerializationStore to the given container.

Overloads

DeserializeTo(SerializationStore, IContainer)

Deserializes the given SerializationStore to the given container.

DeserializeTo(SerializationStore, IContainer, Boolean)

Deserializes the given SerializationStore to the given container, optionally validating recycled types.

DeserializeTo(SerializationStore, IContainer, Boolean, Boolean)

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

DeserializeTo(SerializationStore, IContainer)

Source:
ComponentSerializationService.cs
Source:
ComponentSerializationService.cs
Source:
ComponentSerializationService.cs

Deserializes the given SerializationStore to the given container.

public:
 void DeserializeTo(System::ComponentModel::Design::Serialization::SerializationStore ^ store, System::ComponentModel::IContainer ^ container);
public void DeserializeTo (System.ComponentModel.Design.Serialization.SerializationStore store, System.ComponentModel.IContainer container);
member this.DeserializeTo : System.ComponentModel.Design.Serialization.SerializationStore * System.ComponentModel.IContainer -> unit
Public Sub DeserializeTo (store As SerializationStore, container As IContainer)

Parameters

store
SerializationStore

The SerializationStore to deserialize.

container
IContainer

The container to which IComponent objects will be added.

Exceptions

store or container is null.

store does not contain data in a format the serialization container can process.

Remarks

The DeserializeTo method deserializes store, but instead of producing new objects, it applies the data in the store to an existing set of objects that are taken from the provided container. As a result, the caller can create in advance an object however it sees fit. If an object has a 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 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.

See also

Applies to

DeserializeTo(SerializationStore, IContainer, Boolean)

Source:
ComponentSerializationService.cs
Source:
ComponentSerializationService.cs
Source:
ComponentSerializationService.cs

Deserializes the given SerializationStore to the given container, optionally validating recycled types.

public:
 void DeserializeTo(System::ComponentModel::Design::Serialization::SerializationStore ^ store, System::ComponentModel::IContainer ^ container, bool validateRecycledTypes);
public void DeserializeTo (System.ComponentModel.Design.Serialization.SerializationStore store, System.ComponentModel.IContainer container, bool validateRecycledTypes);
member this.DeserializeTo : System.ComponentModel.Design.Serialization.SerializationStore * System.ComponentModel.IContainer * bool -> unit
Public Sub DeserializeTo (store As SerializationStore, container As IContainer, validateRecycledTypes As Boolean)

Parameters

store
SerializationStore

The SerializationStore to deserialize.

container
IContainer

The container to which IComponent objects will be added.

validateRecycledTypes
Boolean

true to guarantee that the deserialization will only work if applied to an object of the same type.

Exceptions

store or container is null.

store does not contain data in a format the serialization container can process.

Remarks

The DeserializeTo method deserializes store, but instead of producing new objects, it applies the data in the store to an existing set of objects that are taken from the provided container. As a result, the caller can create in advance an object however it sees fit. If an object has a 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 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.

See also

Applies to

DeserializeTo(SerializationStore, IContainer, Boolean, Boolean)

Source:
ComponentSerializationService.cs
Source:
ComponentSerializationService.cs
Source:
ComponentSerializationService.cs

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

public:
 abstract void DeserializeTo(System::ComponentModel::Design::Serialization::SerializationStore ^ store, System::ComponentModel::IContainer ^ container, bool validateRecycledTypes, bool applyDefaults);
public abstract void DeserializeTo (System.ComponentModel.Design.Serialization.SerializationStore store, System.ComponentModel.IContainer container, bool validateRecycledTypes, bool applyDefaults);
abstract member DeserializeTo : System.ComponentModel.Design.Serialization.SerializationStore * System.ComponentModel.IContainer * bool * bool -> unit
Public MustOverride Sub DeserializeTo (store As SerializationStore, container As IContainer, validateRecycledTypes As Boolean, applyDefaults As Boolean)

Parameters

store
SerializationStore

The SerializationStore to deserialize.

container
IContainer

The container to which IComponent objects will be added.

validateRecycledTypes
Boolean

true to guarantee that the deserialization will only work if applied to an object of the same type.

applyDefaults
Boolean

true to indicate that the default property values should be applied.

Exceptions

store or container is null.

store does not contain data in a format the serialization container can process.

Remarks

The DeserializeTo method deserializes store, but instead of producing new objects, it applies the data in the store to an existing set of objects that are taken from the provided container. As a result, the caller can create in advance an object however it sees fit. If an object has a 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 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.

See also

Applies to