ComponentSerializationService.SerializeAbsolute 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
根据默认属性值序列化给定对象。
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
value
的状态将序列化到的 SerializationStore。
- value
- Object
要序列化的对象。
例外
store
或 value
为 null
。
store
已关闭,或 store
不是序列化存储区支持的类型。 使用由 CreateStore() 返回的存储区。
注解
通过 Serialize 方法实现的标准序列化仅序列化不同于组件默认状态的值。 这提供了最精简的序列化机制,但假定在反序列化期间将使用新创建的对象。 如果使用现有对象,则不保证生成的反序列化对象复制序列化对象的原始状态;序列化期间包含默认值的属性在反序列化期间不会重置回其默认值。
方法 SerializeAbsolute 不使用此快捷方式。 它序列化源对象的所有属性,以便反序列化可以还原对象的所有属性,而不考虑默认状态。
此方法对于序列化集合特别有用,因为集合中构成项的顺序可能会更改。 在这种情况下,还原整个集合的原始状态的最安全过程是使用所有原始属性值覆盖所有项。