版本相容序列化回呼

資料合約程式設計模型完整支援 BinaryFormatter 和 SoapFormatter 類別所支援的版本相容序列化回呼方法。

版本相容的屬性

回呼屬性有四個。每個屬性都可以套用至序列化/還原序列化引擎在不同時間呼叫的方法。下表說明何時使用各個屬性。

屬性	呼叫對應方法的時機
OnSerializingAttribute	在序列化型別之前呼叫。
OnSerializedAttribute	在序列化型別之後呼叫。
OnDeserializingAttribute	在還原序列化型別之前呼叫。
OnDeserializedAttribute	在還原序列化型別之後呼叫。

這些方法必須接受 StreamingContext 參數。

這些方法主要是搭配版本處理或初始化使用。在還原序列化期間，不會呼叫建構函式。因此，如果資料成員的資料在傳入資料流中遺失 (例如，當資料來自遺失某些資料成員的舊版型別時)，則這些資料成員可能無法正確地初始化 (做為預設值)。如果要修正這個問題，請使用以 OnDeserializingAttribute 標示的回呼方法，如下例中所示。

每種型別只有一個方法可以標上前述各個回呼屬性。

範例

請參閱

參考

OnSerializingAttribute
OnSerializedAttribute
OnDeserializingAttribute
OnDeserializedAttribute
StreamingContext

其他資源

Version-Tolerant Serialization