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
該 SerializationStore 狀態 value 將被序列化。
- value
- Object
要串連的物件。
例外狀況
store 或 value 為 null。
store 是關閉的,或 store 不是支援的序列化儲存類型。 使用退貨的 CreateStore()商店。
備註
標準序列化透過此 Serialize 方法實作時,僅序列化與元件預設狀態不同的值。 這提供了最簡潔的序列化機制,但假設在反序列化過程中會使用新建立的物件。 若使用現有物件,所產生的反序列化物件無法保證與序列化物件的原始狀態重複;序列化時包含預設值的屬性不會在反序列化時被重置回預設值。
此 SerializeAbsolute 方法並未使用這個捷徑。 它序列化了來源物件的所有屬性,使反序列化能恢復物件的所有屬性,無論預設狀態為何。
此方法特別適合序列化集合,因為集合中組成項目的順序可能會改變。 在這種情況下,恢復整個收藏原始狀態最安全的方法是將所有項目覆蓋為其原始屬性值。