ComponentSerializationService.SerializeAbsolute Метод

Определение

Пространство имен:

System.ComponentModel.Design.Serialization

Сборка:

System.ComponentModel.TypeConverter.dll

Исходный код:

ComponentSerializationService.cs

Выполняет сериализацию заданного объекта, учитывая значения свойств по умолчанию.

public:
 abstract void SerializeAbsolute(System::ComponentModel::Design::Serialization::SerializationStore ^ store, System::Object ^ value);

public abstract void SerializeAbsolute (System.ComponentModel.Design.Serialization.SerializationStore store, object value);

abstract member SerializeAbsolute : System.ComponentModel.Design.Serialization.SerializationStore * obj -> unit

Public MustOverride Sub SerializeAbsolute (store As SerializationStore, value As Object)

Параметры

store

SerializationStore

Класс SerializationStore, в который будет выполнена сериализация состояния параметра value.

value

Object

Объект для сериализации.

Исключения

ArgumentNullException

Параметр store или value имеет значение null.

InvalidOperationException

Хранилище store закрыто, или store не является поддерживаемым типом хранилища сериализации. Используйте хранилище, возвращаемое методом CreateStore().

Комментарии

Стандартная сериализация, реализованная с помощью Serialize метода , сериализует только значения, которые отличаются от состояния компонента по умолчанию. Это обеспечивает наиболее компактный механизм сериализации, но предполагает, что во время десериализации будет использоваться только что созданный объект. Если используется существующий объект, результирующий десериализованный объект не гарантирует дублирование исходного состояния сериализованного объекта; Свойства, содержащие значения по умолчанию во время сериализации, не будут возвращены к значениям по умолчанию во время десериализации.

Метод SerializeAbsolute не использует этот ярлык. Он сериализует все свойства исходного объекта, чтобы десериализация параметров восстанавливала все свойства объекта независимо от состояния по умолчанию.

Этот метод особенно полезен для сериализации коллекций, так как порядок составляющих элементов в коллекции может изменяться. В этом случае самым безопасным процессом восстановления исходного состояния всей коллекции является перезапись всех элементов всеми исходными значениями свойств.

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

• SerializationStore
• MemberDescriptor
• Serialize(SerializationStore, Object)
• SerializeMember(SerializationStore, Object, MemberDescriptor)
• SerializeMemberAbsolute(SerializationStore, Object, MemberDescriptor)