版本相容序列化回呼

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

版本相容的屬性

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

屬性 呼叫對應方法的時機

OnSerializingAttribute

在序列化型別之前呼叫。

OnSerializedAttribute

在序列化型別之後呼叫。

OnDeserializingAttribute

在還原序列化型別之前呼叫。

OnDeserializedAttribute

在還原序列化型別之後呼叫。

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

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

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

範例

請參閱

參考

OnSerializingAttribute
OnSerializedAttribute
OnDeserializingAttribute
OnDeserializedAttribute
StreamingContext

其他資源

Version-Tolerant Serialization