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 не использует этот ярлык. Он сериализует все свойства исходного объекта, чтобы десериализация параметров восстанавливала все свойства объекта независимо от состояния по умолчанию.
Этот метод особенно полезен для сериализации коллекций, так как порядок составляющих элементов в коллекции может изменяться. В этом случае самым безопасным процессом восстановления исходного состояния всей коллекции является перезапись всех элементов всеми исходными значениями свойств.
