ComponentSerializationService.DeserializeTo Method
Definition
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.
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)
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 -> unitPublic 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)
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 -> unitPublic 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)
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 -> unitPublic 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.
