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

要串連的物件。

例外狀況

storevaluenull

store 是關閉的,或 store 不是支援的序列化儲存類型。 使用退貨的 CreateStore()商店。

備註

標準序列化透過此 Serialize 方法實作時,僅序列化與元件預設狀態不同的值。 這提供了最簡潔的序列化機制,但假設在反序列化過程中會使用新建立的物件。 若使用現有物件,所產生的反序列化物件無法保證與序列化物件的原始狀態重複;序列化時包含預設值的屬性不會在反序列化時被重置回預設值。

SerializeAbsolute 方法並未使用這個捷徑。 它序列化了來源物件的所有屬性,使反序列化能恢復物件的所有屬性,無論預設狀態為何。

此方法特別適合序列化集合,因為集合中組成項目的順序可能會改變。 在這種情況下,恢復整個收藏原始狀態最安全的方法是將所有項目覆蓋為其原始屬性值。

適用於

另請參閱