Поделиться через


ComponentSerializationService.SerializeAbsolute Метод

Определение

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

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

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

Исключения

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

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

Комментарии

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

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

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

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

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