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 -> unitPublic MustOverride Sub SerializeAbsolute (store As SerializationStore, value As Object)Параметры
- store
- SerializationStore
SerializationStore Состояние value сериализации.
- value
- Object
Объект для сериализации.
Исключения
store или value есть null.
store закрыт или store не является поддерживаемым типом хранилища сериализации. Используйте хранилище, возвращенное CreateStore().
Комментарии
Стандартная сериализация, реализованная с помощью Serialize метода, сериализует только значения, отличающиеся от состояния компонента по умолчанию. Это обеспечивает самый компактный механизм сериализации, но предполагает, что созданный объект будет использоваться во время десериализации. Если используется существующий объект, результирующий десериализированный объект не гарантирует дублирование исходного состояния сериализованного объекта; Свойства, содержащие значения по умолчанию во время сериализации, не будут сбрасываться обратно в значения по умолчанию во время десериализации.
Метод SerializeAbsolute не использует этот ярлык. Он сериализует все свойства исходного объекта, чтобы десериализация может восстановить все свойства объекта независимо от состояния по умолчанию.
Этот метод особенно полезен для сериализации коллекций, так как порядок составляющих элементов в коллекции может измениться. В этом случае самый безопасный процесс восстановления исходного состояния всей коллекции заключается в перезаписи всех элементов со всеми исходными значениями свойств.
