ComponentSerializationService Класс

Определение

Предоставляет базовый класс для сериализации набора компонентов или сериализуемых объектов в хранилище сериализации.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
Наследование
ComponentSerializationService
Производный

Комментарии

ComponentSerializationServiceСериализует набор компонентов или сериализуемых объектов в хранилище сериализации.The ComponentSerializationService serializes a set of components or serializable objects into a serialization store. Затем хранилище можно будет десериализовать позже.The store can then be deserialized later. ComponentSerializationServiceКласс отличается от других схем сериализации тем, что формат сериализации непрозрачен и обеспечивает частичную сериализацию объектов.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.

Этот класс — abstract .This class is abstract. Как правило, DesignerLoader класс предоставляет конкретную реализацию этого класса и добавляет его в качестве службы в DesignSurface .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.

ComponentSerializationServiceКласс заменяет IDesignerSerializationService интерфейс из .NET Framework версии 1,0, хотя второй сохраняется для обеспечения обратной совместимости.The ComponentSerializationService class replaces the IDesignerSerializationService interface from the .NET Framework version 1.0, although the latter is retained for backward compatibility.

Примечания для тех, кто реализует этот метод

При наследовании от ComponentSerializationService класса необходимо переопределить все методы в этом классе.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. Дополнительные сведения см. в описании класса CodeDomComponentSerializationService.For more information, see the CodeDomComponentSerializationService class.

Конструкторы

ComponentSerializationService()

Инициализирует новый экземпляр класса ComponentSerializationService.Initializes a new instance of the ComponentSerializationService class.

Методы

CreateStore()

Создает новый экземпляр SerializationStore.Creates a new SerializationStore.

Deserialize(SerializationStore)

Выполняет десериализацию заданного хранилища для создания коллекции объектов.Deserializes the given store to produce a collection of objects.

Deserialize(SerializationStore, IContainer)

Выполняет десериализацию заданного хранилища и заполняет заданное хранилище IContainer десериализованными объектами IComponent.Deserializes the given store and populates the given IContainer with deserialized IComponent objects.

DeserializeTo(SerializationStore, IContainer)

Выполняет десериализацию заданного объекта SerializationStore в заданный контейнер.Deserializes the given SerializationStore to the given container.

DeserializeTo(SerializationStore, IContainer, Boolean)

Выполняет десериализацию заданного объекта SerializationStore в заданный контейнер (при необходимости выполняется проверка очищенных типов).Deserializes the given SerializationStore to the given container, optionally validating recycled types.

DeserializeTo(SerializationStore, IContainer, Boolean, Boolean)

Выполняет десериализацию заданного объекта SerializationStore в заданный контейнер (при необходимости применяются значения свойств по умолчанию).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.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
LoadStore(Stream)

Загружает хранилище SerializationStore из потока.Loads a SerializationStore from a stream.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
Serialize(SerializationStore, Object)

Выполняет сериализацию заданного объекта в заданное хранилище SerializationStore.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.

(Унаследовано от Object)

Применяется к

См. также раздел