语言

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 不使用此快捷方式。 它序列化源对象的所有属性,以便反序列化可以还原所有对象的属性,而不考虑默认状态。

此方法特别适用于序列化集合,因为集合中构成项的顺序可能会更改。 在这种情况下,还原整个集合的原始状态的最安全过程是使用其所有原始属性值覆盖所有项。

适用于

另请参阅