ComponentSerializationService Class
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.
Provides the base class for serializing a set of components or serializable objects into a serialization store.
public ref class ComponentSerializationService abstract
public abstract class ComponentSerializationService
type ComponentSerializationService = class
Public MustInherit Class ComponentSerializationService
- Inheritance
-
ComponentSerializationService
- Derived
Remarks
The ComponentSerializationService serializes a set of components or serializable objects into a serialization store. The store can then be deserialized later. The ComponentSerializationService class differs from other serialization schemes in that the serialization format is opaque, and it allows for partial serialization of objects. For example, you can choose to serialize only selected properties for an object.
This class is abstract
. Typically, a DesignerLoader will provide a concrete implementation of this class and add it as a service to its DesignSurface. This allows objects to be serialized in the format best suited for them.
The ComponentSerializationService class replaces the IDesignerSerializationService interface from the .NET Framework version 1.0, although the latter is retained for backward compatibility.
Notes to Implementers
When you inherit from the ComponentSerializationService class, you must override all the methods in this class. Some of these methods were designed to throw exceptions, as documented in their corresponding topics; it is strongly recommended that derived classes follow these guidelines to maintain consistency of operation. For more information, see the CodeDomComponentSerializationService class.
Constructors
ComponentSerializationService() |
Initializes a new instance of the ComponentSerializationService class. |
Methods
CreateStore() |
Creates a new SerializationStore. |
Deserialize(SerializationStore) |
Deserializes the given store to produce a collection of objects. |
Deserialize(SerializationStore, IContainer) |
Deserializes the given store and populates the given IContainer with deserialized IComponent objects. |
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. |
Equals(Object) |
Determines whether the specified object is equal to the current object. (Inherited from Object) |
GetHashCode() |
Serves as the default hash function. (Inherited from Object) |
GetType() |
Gets the Type of the current instance. (Inherited from Object) |
LoadStore(Stream) |
Loads a SerializationStore from a stream. |
MemberwiseClone() |
Creates a shallow copy of the current Object. (Inherited from Object) |
Serialize(SerializationStore, Object) |
Serializes the given object to the given SerializationStore. |
SerializeAbsolute(SerializationStore, Object) |
Serializes the given object, accounting for default property values. |
SerializeMember(SerializationStore, Object, MemberDescriptor) |
Serializes the given member on the given object. |
SerializeMemberAbsolute(SerializationStore, Object, MemberDescriptor) |
Serializes the given member on the given object, accounting for the default property value. |
ToString() |
Returns a string that represents the current object. (Inherited from Object) |