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 不會使用此快捷方式。 它會串行化來源物件的所有屬性,以便還原串行化可以還原所有對象的屬性,而不論默認狀態為何。
這個方法特別適用於串行化集合,因為集合內的組成項目順序可能會變更。 在此情況下,還原整個集合原始狀態的最安全程式是使用其所有原始屬性值覆寫所有專案。